ListAIImageInfo - 查询智能封面信息

调用ListAIImageInfo查询指定视频下的AI图片信息。

接口说明

使用说明

本接口只能查询单个视频下的AI图片信息,不支持批量查询。

  • 国际站暂不支持智能封面功能,本接口暂不支持在国际站调用。
  • 本接口只能查询单个视频下的AI图片信息,不支持批量查询。

QPS限制

本接口的单用户QPS限制为100次/秒。超过限制,API调用会被限流,这可能会影响您的业务,请合理调用。更多信息,请参见QPS限制

调试

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

调试

授权信息

当前API暂无授权信息透出。

请求参数

名称类型必填描述示例值
VideoIdstring

视频ID。可通过以下方式获取:

  • 通过控制台上传的视频,可登录点播控制台,选择媒资库 > 音/视频查看视频ID。
  • 通过获取视频上传地址和凭证接口获取上传地址和凭证时,视频ID为返回参数VideoId的值。
  • 视频上传后,可通过搜索媒体信息接口查询视频ID,为请求后返回参数VideoId的值。
357a8748c5789d2726e6436aa****

返回参数

名称类型描述示例值
object

返回结果。

RequestIdstring

请求ID。

D73420CD-D221-9122-5B8FA995A511****
AIImageInfoListarray

AI图片文件列表。

object

AI图片文件详情。

CreationTimestring

数据创建时间。格式为:yyyy-MM-ddTHH:mm:ssZ(UTC时间)。

2020-10-15T03:30:03Z
AIImageInfoIdstring

图片数据信息ID。

b89a6aabf1b6197ebd6fe6cf29****
FileURLstring

AI图片文件地址。

http://example.aliyundoc.com/357a8748c5789d2726e6436aa****/image/ai/b0a7612554d6400013-0****.gif?auth_key=1602745717-0-0-005ee05616c5925596d****
Versionstring

数据版本ID。

b547f3f0e199c3b457369f3cf****
VideoIdstring

视频ID。

357a8748c5789d2726e6436aa****
JobIdstring

AI图片处理任务ID。

cf08a2c6e11ee1711b738b9067****
Scorestring

图片评分。

5.035636554444242
Formatstring

图片格式。取值:gifpng

gif

示例

请求示例

http(s)://vod.cn-shanghai.aliyuncs.com/?Action=ListAIImageInfo
&VideoId=357a8748c5789d2726e6436aa****
&公共请求参数

正常返回示例

JSON格式

{
    "RequestId": "D73420CD-D221-9122-5B8FA995A511****",
    "AIImageInfoList": [
        {
            "CreationTime": "2020-10-15T03:30:03Z",
            "AIImageInfoId": "b89a6aabf1b6197ebd6fe6cf29****",
            "FileURL": "http://example.aliyundoc.com/357a8748c5789d2726e6436aa****/image/ai/b0a7612554d6400013-0****.gif?auth_key=1602745717-0-0-005ee05616c5925596d****",
            "Version": "b547f3f0e199c3b457369f3cf****",
            "VideoId": "357a8748c5789d2726e6436aa****",
            "JobId": "cf08a2c6e11ee1711b738b9067****",
            "Score": "5.035636554444242",
            "Format": "gif"
        }
    ]
}

XML格式

<ListAIImageInfoResponse>
    <RequestId>D73420CD-D221-9122-5B8FA995A511****</RequestId>
    <AIImageInfoList>
        <CreationTime>2020-10-15T03:30:03Z</CreationTime>
        <AIImageInfoId>b89a6aabf1b6197ebd6fe6cf29****</AIImageInfoId>
        <FileURL>http://example.aliyundoc.com/357a8748c5789d2726e6436aa****/image/ai/b0a7612554d6400013-0****.gif?auth_key=1602745717-0-0-005ee05616c5925596d****</FileURL>
        <Version>b547f3f0e199c3b457369f3cf****</Version>
        <VideoId>357a8748c5789d2726e6436aa****</VideoId>
        <JobId>cf08a2c6e11ee1711b738b9067****</JobId>
        <Score>5.035636554444242</Score>
        <Format>gif</Format>
    </AIImageInfoList>
</ListAIImageInfoResponse>

错误码

访问错误中心查看更多错误码。

阿里云首页 视频点播 相关技术圈