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

使用说明

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

QPS限制

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

调试

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

请求参数

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

系统规定参数。取值：ListAIImageInfo。

VideoId String 是 357a8748c5789d2726e6436aa****

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

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

返回数据

名称 类型 示例值 描述
RequestId String D73420CD-D221-9122-5B8FA995A511****

请求ID。
AIImageInfoList Array of AIImageInfo

AI图片文件列表。
CreationTime String 2020-10-15T03:30:03Z

数据创建时间。格式为：yyyy-MM-ddTHH:mm:ssZ（UTC时间）。

AIImageInfoId String b89a6aabf1b6197ebd6fe6cf29****

图片数据信息ID。
FileURL String http://example.aliyundoc.com/357a8748c5789d2726e6436aa****/image/ai/b0a7612554d6400013-0****.gif?auth_key=1602745717-0-0-005ee05616c5925596d****

AI图片文件地址。
Version String b547f3f0e199c3b457369f3cf****

数据版本ID。
VideoId String 357a8748c5789d2726e6436aa****

视频ID。
JobId String cf08a2c6e11ee1711b738b9067****

AI图片处理任务ID。
Score String 5.035636554444242

图片评分。
Format String gif

图片格式。取值：gif或png。

示例

请求示例

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

正常返回示例

XML格式 

HTTP/1.1 200 OK
Content-Type:application/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>

JSON格式 

HTTP/1.1 200 OK
Content-Type:application/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"
  } ]
}

错误码

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

SDK示例

建议使用服务端SDK来调用API，此API各语言调用的示例代码，请参见：