Skip to main content
Get video task
Use the returned task id and the same account’s API key. Seedance 2.0 and 2.5 share this endpoint. Try it prefills the most recent task ID and API key from this page session; you can also enter them manually. After creation, select Query task to continue without re-entering these fields. The API key is shared only in the current page session and cleared on refresh or close. queued means queued and running means processing. When succeeded, read content.video_url. For failed, cancelled or expired, inspect error.code and error.message.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

id
string
required

Local task ID returned on creation; only tasks owned by the caller are accessible.

Response

OK

id
string
required
model
string
required
status
enum<string>
required
Available options:
queued,
running,
succeeded,
failed,
cancelled,
expired
content
object
required
usage
object
required
created_at
integer<int64>
required
updated_at
integer<int64>
required
error
object
framespersecond
integer
draft_task_id
string
resolution
string

Resolution; supported values and combinations depend on the model and channel.

ratio
string

Aspect ratio; adaptive is supported.

duration
integer

Duration in seconds; -1 selects automatically. frames takes precedence.

frames
integer

Output frame count, subject to model support.

seed
integer

Random seed, subject to model support.

execution_expires_after
integer

Task execution expiry in seconds; forwarded for both 2.0 and 2.5.

generate_audio
boolean

Generate synchronized audio.

tools
object[]

Tool list; nested parameters are preserved.

output_format
string

Output format according to the model contract.

service_tier
string

Service tier; tiers such as flex depend on model support.

draft
boolean

Draft mode, subject to model support.

priority
integer

Execution priority, 0–9.

Required range: 0 <= x <= 9
safety_identifier
string

Caller safety identifier.