Create Video Generation Task

Create an asynchronous video generation task. Supports multiple input modes:

Text-to-video
Image-to-video (first frame / first+last frame)
Multimodal reference (image + video + audio combinations)
Video editing
Video extension
Web search enhanced generation

Poll GET /v1/video/generations/{id} until status is succeeded.

Request body

model'seedance-2.0-ultra' required

Model ID

generate_audioboolean

Generate synchronized audio with the video.

true — Video includes auto-generated voice, sound effects, and background music
false — Silent video

resolution'720p' | '1080p' | '2k' required

Output video resolution. Required for Ultra.

ratio'16:9' | '4:3' | '1:1' | '3:4' | '9:16' | '21:9' | 'adaptive'

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

durationinteger

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

watermarkboolean

Add watermark to the generated video.

Example request

{
  "model": "seedance-2.0-ultra",
  "content": [
    {
      "type": "text",
      "text": "A cat playing piano in a sunlit room"
    },
    {
      "type": "image_url",
      "image_url": {
        "url": "https://example.com/reference.jpg"
      },
      "role": "reference_image"
    }
  ],
  "resolution": "720p"
}

Response

Video generation task created

idstring

Task ID for polling

task_idstring

Task ID (same as id)

objectstring

modelstring

statusstring

Initially empty

progressinteger

created_atinteger

Unix timestamp

Example response

{
  "id": "cgt-20260312231129-7db6s",
  "task_id": "cgt-20260312231129-7db6s",
  "object": "video",
  "model": "seedance-2.0-ultra",
  "created_at": 1773328294
}