功能描述

此接口通过 Job 方式创建视频转动图任务，将源视频按指定时间区间、帧率、帧间隔等参数抽帧合成为动图（GIF/WebP），并按指定大小缩放输出。

注意事项

仅支持异步方式提交视频转动图任务，任务提交后返回 JobId，可通过 GetVideoAnimationJob 接口查询任务处理状态。

使用子账号操作时，请先在访问控制 > 权限策略中创建或编辑自定义策略，为当前桶添加 tos:CreateMediaProcessJobs 权限，再将该策略绑定至需要使用本功能的子账号。

视频封装格式：MP4/TS/MKV 。

视频编码格式：H264/H265/VP8/VP9/AV1。

视频分辨率限制：[128,4096]。

视频大小限制：视频长度不超过 15 分钟。

请求消息样式

请求参数和消息头

该请求使用的公共请求消息头，请参见公共参数。

名称	位置	参数类型	是否必选	示例值	说明
media_jobs	Query	String	是	-	代表媒体任务的请求特殊标识。
job_type	Query	String	是	Animation	任务类型，视频转动图场景下取值仅为 Animation。

请求元素

名称	参数类型	是否必填	示例值	说明
Input	String	是	-	源文件。
Object	String	是	test.mp4	待转换的源视频文件。
AnimationConfig	String	是	-	视频转动图的配置。
TimeInterval	String	否	-	截取源视频的时间区间。父节点：AnimationConfig
Animation	String	是	-	动图画面参数配置。父节点：AnimationConfig
Start	Integer	否	1000	视频转动图的起始时间，单位为毫秒。取值如下： 0（默认值）：从起始位置开始。大于0：从第 ss 毫秒开始。父节点：TimeInterval
Duration	Integer	否	5000	截取时长，单位为毫秒，取值范围 ≥ 0。默认值为 0，值为 0时表示截取至视频末尾。父节点：TimeInterval
Container	String	是	-	输出动图的容器格式配置。父节点：AnimationConfig
Format	String	是	gif	输出动图格式，取值如下： gif。 webp 。父节点：Container
FrameNum	Integer	否	100	动图帧数量，默认不限制数量（抽帧到视频结束）。当视频长度不足时，实际抽帧数量会小于设定的参数值。父节点：Animation
FrameInterval	Integer	否	1	动图抽帧间隔，单位为毫秒，默认抽取所有视频帧。当该参数小于源视频帧间隔（帧率倒数）时，会按源视频帧间隔进行抽帧。父节点：Animation
Fps	Integer	否	30	动图帧率，默认为 FrameInterval 倒数。取值范围为 [0, 240]。该参数控制动图的播放速度。等于默认值时，播放速度与源视频一致。。大于默认值时，产生加速效果。小于默认值时，产生减速效果。父节点：Animation
Width	Integer	否	1024	输出动图的宽度，单位为 px，取值范围为 [32,4096]。如果指定宽度为 0，则按源视频的分辨率比例自动计算。父节点：Animation
Height	Integer	否	1024	输出动图的高度，单位为 px，取值范围为 [32,4096]。如果指定高度为 0，则按源视频的分辨率比例自动计算。父节点：Animation
ScaleType	String	否	crop	缩放方式。取值如下： crop：缩放并裁剪。 stretch（默认值）：拉伸以填满。 fill：缩放并保留黑边。 fit：缩放并不保留黑边，等比缩放。父节点：Animation
Output	String	是	-	输出动图的存储配置。
Region	String	是	cn-qingdao-test	动图的存储地域。父节点：Output
Bucket	String	是	data-process-bench	存储动图的存储桶。父节点：Output
Object	String	是	example.gif	输出动图的对象名称。支持使用 ${input}、${run_id}、${output_format} 等占位符自动生成名称，例如设置为 ${input}.gif 时，将以源视频名称为前缀生成动图。父节点：Output

响应消息头

该请求返回的公共响应消息头，请参见公共参数。

响应元素

名称	参数类型	示例值	说明
Code	String	OK	状态码。
Message	String	Success	请求状态信息。
JobId	String	18b70baab0e26a39d0ef000137b5********	视频转动图任务 ID。可使用该 ID 通过 GetVideoAnimationJob 查询任务的执行状态与结果。

请求示例

响应示例

对象存储