调用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

图片格式。取值:gifpng

示例

请求示例

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各语言调用的示例代码,请参见: