调用ListDynamicImage,通过视频ID查询视频截动图列表。

使用说明

  • 视频动图截取完成后,可以调用本接口来获取视频的动图信息。
  • 视频动图任务可通过API(提交媒体动图作业接口)或控制台发起,更多内容,请参见视频动图

QPS限制

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

调试

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

请求参数

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

系统规定参数。取值:ListDynamicImage

VideoId String 2e114f1100590c3193918fd449a****

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

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

返回数据

名称 类型 示例值 描述
RequestId String 570189B6-572E-4953-13B4278EE0D8****

请求ID。

DynamicImageList Array of DynamicImage

动图结果。

CreationTime String 2020-07-28T02:01:06Z

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

FileURL String https://example.aliyundoc.com/2e114f110059*****0c3193918fd449a/image/dynamic/2b4e51df60*****323ef43d6e336ecf.webp?auth_key=1597296785-0-0-4a48e85*****bd2bb358e0b3cade

动图文件地址。

VideoId String 2e114f1100590c3193918fd449a****

视频ID。

Width String 640

动图宽。单位:px。

JobId String 2bf4390af9e5491c09cc720ad****

动图作业ID。

Height String 360

动图高。单位:px。

Fps String 10

动图帧率。单位:帧/每秒。

Duration String 2

动图时长。单位:秒。

Format String webp

动图格式,取值:

  • gif
  • webp
DynamicImageId String 2b4e51df60323ef43d6e336ecf****

动图ID。

FileSize String 119866

动图文件大小。单位:Byte。

示例

请求示例

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

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<ListDynamicImageResponse>
    <RequestId>570189B6-572E-4953-13B4278EE0D8****</RequestId>
    <DynamicImageList>
        <CreationTime>2020-07-28T02:01:06Z</CreationTime>
        <FileURL>https://example.aliyundoc.com/2e114f110059*****0c3193918fd449a/image/dynamic/2b4e51df60*****323ef43d6e336ecf.webp?auth_key=1597296785-0-0-4a48e85*****bd2bb358e0b3cade</FileURL>
        <VideoId>2e114f1100590c3193918fd449a****</VideoId>
        <Width>640</Width>
        <JobId>2bf4390af9e5491c09cc720ad****</JobId>
        <Height>360</Height>
        <Fps>10</Fps>
        <Duration>2</Duration>
        <Format>webp</Format>
        <DynamicImageId>2b4e51df60323ef43d6e336ecf****</DynamicImageId>
        <FileSize>119866</FileSize>
    </DynamicImageList>
</ListDynamicImageResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "570189B6-572E-4953-13B4278EE0D8****",
  "DynamicImageList" : [ {
    "CreationTime" : "2020-07-28T02:01:06Z",
    "FileURL" : "https://example.aliyundoc.com/2e114f110059*****0c3193918fd449a/image/dynamic/2b4e51df60*****323ef43d6e336ecf.webp?auth_key=1597296785-0-0-4a48e85*****bd2bb358e0b3cade",
    "VideoId" : "2e114f1100590c3193918fd449a****",
    "Width" : "640",
    "JobId" : "2bf4390af9e5491c09cc720ad****",
    "Height" : "360",
    "Fps" : "10",
    "Duration" : "2",
    "Format" : "webp",
    "DynamicImageId" : "2b4e51df60323ef43d6e336ecf****",
    "FileSize" : "119866"
  } ]
}

错误码

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