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

功能描述

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

前提条件

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

调试

您可以在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地址。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>

JSON 格式

{
  "RequestId": "5B95B724-C5B9-4F77-A743-0CA4EA95CC82"
}

查询任务结果

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

错误码

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

SDK参考

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

安全声明

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