Skip to main content
GET
Query video generation task status
Use the task_id returned when creating a video task to query its status. After the task succeeds, the response includes the video URL.
Poll every 10-15 seconds. Video generation typically takes from tens of seconds to a few minutes.

Polling example

Python

Headers

Authorization
string
required

API Key token (Bearer sk-xxx)

Content-Type
string

Path Parameters

taskId
string
required

Response

200 - application/json

Generic video task status query response

task_id
string

Task ID

video_url
string

Video URL (on success; upstream address)

video_duration
number

Video duration (seconds, on success)

error_code
string

Error code (on failure)

error_message
string

Error message (on failure)

status
string

Task status: queued / running / succeeded / failed / cancelled / expired

resolution
string

Generated video resolution: 480p / 720p / 1080p / 4k

ratio
string

Generated video aspect ratio: 16:9 / 4:3 / 1:1 / 3:4 / 9:16 / 21:9

model
string

Platform model number (model_no, used to replace the upstream model name during protocol pass-through)

created
integer<int64>

Creation time (epoch milliseconds) - UTC

updated
integer<int64>

Update time (epoch milliseconds) - UTC

usage
object

Usage statistics (on success; duration fields from Wan usage, token fields from seedance usage)