Description

This interface queries the asynchronous task status of video-to-animation conversion.

Notes

When using a sub-account, it must have the relevant permissions required for GetDataProcessJob data processing.

Querying audio and video asynchronous tasks supports only synchronous processing (x-tos-process processing mode).

Request syntax

Request parameters and headers

For common request headers, see Common parameters.

Name		Type	Required	Example value	Description
job_type	Query	String	Yes	Transcode	Audio and video task types. Supported query types currently include: Transcode Remux Animation
job_id	Query	String	Yes	183535129563a53bfa71000188**********	Audio and video task ID.

Request body elements

No elements are used.

Response headers

The response contains common headers. For more information, see Common Parameters.

Response body elements

Common elements

Name	Type	Example value	Description
JobID	String	183535129563a53bfa71000188**********	Task ID.
CreateTime	String	2025-11-18T20:32:54+08:00	Task creation time.
StartTime	String	2025-11-18T20:32:55+08:00	Task start time.
EndTime	String	2025-11-18T20:32:55+08:00	Task end time.
State	String	Success	Task status.
Code	Integer	0	Task status code.
Message	String	Success	Task status message.
Input	Container	-	Input file.
Object	String	sample.mp4	Enter the input file object name. Parent node: Input.
Output	Container	-	Output file.
Region	String	cn-beijing	Region where the output file bucket is located. Parent node: Output.
Bucket	String	testbkt	Output file bucket name. Parent node: Output.
Object	String	output.gif	Name of the output file object. Parent node: Output.

Additional elements returned when the task type is Animation

Field name	Type	Example value	Description
Width	Integer	1024	Output GIF width in px, range [32,4096]. tip If set to 0, it calculates automatically based on the source video's resolution ratio.
Height	Integer	1024	Height of the output animation in px, range [32,4096]. tip If set to 0, it calculates automatically based on the source video's resolution ratio.
Fps	Integer	30	Animated image frame rate. The default value is automatically calculated from the interval of the source video. Range: [0, 240]. tip This parameter controls the playback speed of the animated image. The default value matches the source video's playback speed. Values higher than the default will speed up playback; values lower will slow it down.
FrameInterval	Integer	1	GIF frame extraction interval in milliseconds; by default, all video frames are extracted. warning If this parameter is less than the source video's frame interval (the inverse of the frame rate), frame extraction follows the source video frame interval.
FrameNum	Integer	100	Number of animated frames, default is unlimited (frames extracted until the video ends). warning If the video length is insufficient, the actual number of extracted frames will be less than the set parameter.
ScaleType	String	crop	Zoom mode. The options are as follows: crop: Scale and crop. stretch (Default): Stretch to fill. fill: Scale and maintain black borders. fit: Scale without preserving black borders, proportional scaling.

Sample request

Sample response