文档中心

对象存储

视频转动图

GetVideoAnimationJob

GetVideoAnimationJob

功能描述

此接口用于查询视频转动图异步任务处理状态。

注意事项

通过子账号使用时，必须拥有 GetDataProcessJob 数据处理所需的相关权限。

查询音视频异步任务仅支持同步处理（x-tos-process 处理方式）。

请求消息样式

请求参数和消息头

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

参数名称	位置	参数类型	是否必选	示例值	说明
job_type	Query	String	是	Animation	视频转动图任务类型，当前支持查询的任务类型有： Transcode Remux Animation
job_id	Query	String	是	183535129563a53bfa710001887ae45ac629	视频转动图任务 ID。

请求元素

该请求不使用消息元素。

响应消息头

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

响应元素

公共元素

参数名称	参数类型	示例值	说明
JobID	String	183535129563a53bfa710001887a********	任务 ID。
CreateTime	String	2025-11-18T20:32:54+08:00	任务创建时间。
StartTime	String	2025-11-18T20:32:55+08:00	任务开始时间。
EndTime	String	2025-11-18T20:32:55+08:00	任务结束时间。
State	String	Success	任务状态。
Code	Integer	0	任务状态码。
Message	String	Success	任务状态消息。
Input	Container	-	输入文件。
Object	String	sample.mp4	输入文件对象名。父节点：Input。
Output	Container	-	输出文件。
Region	String	cn-beijing	输出文件桶所在 Region。父节点：Output。
Bucket	String	testbkt	输出文件桶名。父节点：Output。
Object	String	output.gif	输出文件对象名。父节点：Output。

任务类型为 Animation 时返回的额外元素

名称	参数类型	示例值	说明
Width	Integer	1024	输出动图的宽度，单位为 px，取值范围为 [32,4096]。说明如果指定为 0，则按源视频的分辨率比例自动计算。
Height	Integer	1024	输出动图的高度，单位为 px，取值范围为 [32,4096]。说明如果指定为 0，则按源视频的分辨率比例自动计算。
Fps	Integer	30	动图帧率，默认为 inter 倒数。取值范围为 [0, 240]。说明该参数控制动图的播放速度，当为默认值时与源视频播放速度一致。比默认值大将产生加速效果，比默认值小将产生减速效果。
FrameInterval	Integer	1	动图抽帧间隔，单位为毫秒，默认抽取所有视频帧。注意当该参数小于源视频帧间隔（帧率倒数）时，会按源视频帧间隔进行抽帧。
FrameNum	Integer	100	动图帧数量，默认为不限制数量（抽帧到视频结束）。注意当视频长度不足时，实际抽帧数量会小于设定的参数值。
ScaleType	String	crop	缩放方式。取值如下： crop：缩放并裁剪。 stretch（默认值）：拉伸以填满。 fill：缩放并保留黑边。 fit：缩放并不保留黑边，等比缩放。

请求示例

响应示例

最近更新时间：2026.08.03 15:17:35

这个页面对您有帮助吗？

有用

有用

无用

无用