本文介绍视频封面GenerateVideoCover的语法及示例。

功能描述

视频封面可以检测输入的视频，输出多个视频封面。

前提条件

请确保您已开通视频理解服务，若未开通服务请立即开通。

输入限制

  • 视频格式：MP4、RMVB、FLV、TS。
  • 视频大小：不超过2GB。
  • 视频分辨率：不超过1080P。
  • URL地址中不能包含中文字符。

计费说明

关于视频封面的计费方式及报价，请参见计费介绍。

说明 下方调试接口为付费接口，如需免费体验调试请前往体验中心。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 GenerateVideoCover

要执行的操作。取值：GenerateVideoCover。
IsGif Boolean 是 false

是否输出GIF格式的封面。true表示输出GIF格式封面，false表示输出普通图片封面。
VideoUrl String 是 https://viapi-test.oss-cn-shanghai.aliyuncs.com/test-team/tiankong/1044047354-%E7%99%BD%E5%8F%91-01-1.mp4

视频URL地址。当前仅支持上海地域的OSS链接，如何生成URL请参见生成URL。

返回数据

名称 类型 示例值 描述
Data Struct

返回的结果数据内容。
Outputs Array of Output

返回信息列表，每个元素是一张封面图，可能返回多张封面图。成功时有返回信息。
Confidence Float 6.1819260887924425

置信度，值越高表示可信度越高。
ImageURL String http://algo-app-aic-vd-cn-shanghai-prod.oss-cn-shanghai.aliyuncs.com/video-cover/2020-05-11-07/pic_lOyxGGAqQYSANGxP.mp4_202_544_960_c9f88b2a5f75e17c093d1a65f5edff4d_beautified.png?Expires=1589185385&OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRp****&Signature=PAalKsfeZC4UQzYDTU%2F3D1G7Xt****

输出封面图片的URL地址。
RequestId String 5B95B724-C5B9-4F77-A743-0CA4EA95CC82

请求ID。

示例

请求示例

http(s)://[Endpoint]/?Action=GenerateVideoCover
&IsGif=false
&VideoUrl=https://viapi-test.oss-cn-shanghai.aliyuncs.com/test-team/tiankong/1044047354-%E7%99%BD%E5%8F%91-01-1.mp4
&<公共请求参数>

正常返回示例

XML格式 

<RequestId>5B95B724-C5B9-4F77-A743-0CA4EA95CC82</RequestId>
<Data>
    <Outputs>
        <Confidence>6.1819260887924425</Confidence>
        <ImageURL>http://algo-app-aic-vd-cn-shanghai-prod.oss-cn-shanghai.aliyuncs.com/video-cover/2020-05-11-07/pic_lOyxGGAqQYSANGxP.mp4_202_544_960_c9f88b2a5f75e17c093d1a65f5edff4d_beautified.png?Expires=1589185385&amp;OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRp****&amp;Signature=PAalKsfeZC4UQzYDTU%2F3D1G7Xt****</ImageURL>
    </Outputs>
</Data>

JSON格式 

{
    "RequestId": "5B95B724-C5B9-4F77-A743-0CA4EA95CC82",
    "Data": {
        "Outputs": {
            "Confidence": 6.1819260887924425,
            "ImageURL": "http://algo-app-aic-vd-cn-shanghai-prod.oss-cn-shanghai.aliyuncs.com/video-cover/2020-05-11-07/pic_lOyxGGAqQYSANGxP.mp4_202_544_960_c9f88b2a5f75e17c093d1a65f5edff4d_beautified.png?Expires=1589185385&amp;OSSAccessKeyId=LTAI4FoLmvQ9urWXgSRp****&amp;Signature=PAalKsfeZC4UQzYDTU%2F3D1G7Xt****"
        }
    }
}

查询任务结果

该接口为异步接口，当前并未返回真实的请求结果，您需要通过返回的RequestId调用GetAsyncJobResult接口来获取该接口的真实请求结果。详情请参见GetAsyncJobResult。

错误码

关于视频封面的错误码，详情请参见常见错误码。

SDK参考

阿里云视觉AI能力支持使用SDK调用，具体可参见SDK总览下载安装。

安全声明

  • 请确保上传的图片或文件来源符合相应的法律法规。
  • 通过体验调试上传的临时文件有效期为1小时，在24小时后会被系统自动清理删除。