Skip to main content
POST
Create a video job

Authorizations

Authorization
string
header
required

Your td- key from Tokens

Headers

Idempotency-Key
string

Your own unique ID for this video, up to 256 characters. Repeating a request with the same key returns the same job and does not charge again

Example:

"order-1042-video"

Body

application/json
model
enum<string>
required
Available options:
seedance-2.5,
seedance-2.0
prompt
string
required
Example:

"slow dolly shot of a perfume bottle on plum velvet, soft studio light"

duration
integer
default:5

Whole seconds. Seedance 2.5: 4 to 30. Seedance 2.0: 5 to 15

resolution
enum<string>
default:720p

4k is Seedance 2.0 only

Available options:
480p,
720p,
1080p,
4k
aspect_ratio
enum<string>
default:16:9
Available options:
16:9,
9:16,
1:1,
4:3,
3:4,
21:9

Response

Job created

id
string
Example:

"at_0b6f2c1e-6f1d-4a43-9d4e-2a7c1d9e5b10"

object
string
Example:

"video.task"

model
string
Example:

"seedance-2.5"

status
string

queued and running: keep polling. completed: download the video. failed or cancelled: not charged. Any other value: keep polling the same ID

Example:

"queued"

created_at
integer
Example:

1792560000

billing_status
enum<string>
Available options:
held,
settled,
refunded
result
object | null
error
object | null