Skip to main content
GET
Query task (seedance compatible protocol response)
Use the id returned at creation to query the task. The response preserves Seedance protocol fields, with the video URL in content.video_url after success.
Poll every 10-15 seconds. If you set return_last_frame: true, the successful response also includes a last-frame URL that you can use to continue into another video segment.

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
created_at
integer<int64>

Task creation time (Unix timestamp, seconds)

updated_at
integer<int64>

Task last update time (Unix timestamp, seconds)

framespersecond
integer

Generated video frame rate

generate_audio
boolean

Whether the generated video contains audio synchronized with the visuals. This parameter is only supported in seedance 2.0 & 2.0 fast and seedance 1.5 pro. true: the model outputs a video with synchronized audio. false: outputs a silent video.

safety_identifier
string

Unique identifier of the end user. If this parameter is set when creating the video generation task, the API returns it unchanged.

service_tier
string

Service tier: default online inference / flex offline inference

execution_expires_after
integer

Task timeout threshold, in seconds

draft_task_id
string

Draft video task ID. Returned when generating a final video from a draft video

id
string

Task ID

model
string

Model name

status
string

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

error
object

Error information (returned when the task fails)

content
object

Generated result content (returned when the task succeeds)

usage
object

Token usage statistics

seed
integer<int64>

Random seed

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

duration
integer

Generated video duration (seconds)

frames
string

Generated video frame count. Note: only one of duration and frames is returned. If a frame count is specified in the create video generation request, the frame count is returned.

priority
integer

Execution priority of the current request

draft
boolean

Whether the generated video is a draft video. This parameter is only returned by seedance 1.5 pro. true: the current output is a draft video. false: the current output is a standard video.