Skip to main content
POST
Create Video Generation Task

Authorizations

Authorization
string
header
required

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

Body

application/json
model
enum<string>
required

Model ID

Available options:
seedance-2.0-ultra
Example:

"seedance-2.0-ultra"

content
object[]
required

Input content array for video generation. Supports text, images, videos, and audio in various combinations:

  • Text only
  • Text (optional) + Image(s)
  • Text (optional) + Video(s)
  • Text (optional) + Image + Audio
  • Text (optional) + Image + Video
  • Text (optional) + Video + Audio
  • Text (optional) + Image + Video + Audio
Example:
resolution
enum<string>
required

Output video resolution. Required for Ultra.

Available options:
720p,
1080p,
2k
Example:

"720p"

generate_audio
boolean
default:true

Generate synchronized audio with the video.

  • true — Video includes auto-generated voice, sound effects, and background music
  • false — Silent video
ratio
enum<string>
default:adaptive

Output aspect ratio. adaptive automatically selects the best ratio based on input.

Available options:
16:9,
4:3,
1:1,
3:4,
9:16,
21:9,
adaptive
duration
integer
default:5

Video duration in seconds (integer, 4–15).

Required range: 4 <= x <= 15
tools
object[]

Tools for the model to use. Currently supports web search (text-to-video only).

watermark
boolean
default:false

Add watermark to the generated video.

Response

Video generation task created

id
string

Task ID for polling

Example:

"cgt-20260312231129-7db6s"

task_id
string

Task ID (same as id)

Example:

"cgt-20260312231129-7db6s"

object
string
Example:

"video"

model
string
Example:

"seedance-2.0-ultra"

status
string

Initially empty

Example:

""

progress
integer
Example:

0

created_at
integer

Unix timestamp

Example:

1773328294