Video generation

POST /v1/videos submits an asynchronous video generation job. Balance is reserved when the job starts and charged when it completes (video is billed per second).

Request body

{
  "model": "seedance-2.5/text-to-video",
  "prompt": "Your prompt here",
  "aspect_ratio": "16:9",
  "resolution": "720p",
  "duration": 5,
  "generate_audio": false,
  "image_url": "https://...",
  "video_url": "https://..."
}

Field	Required	Description
`model`	Yes	Model ID, e.g. `seedance-2.5/text-to-video`
`prompt`	For text-to-video	Text description of the scene
`aspect_ratio`	No	e.g. `16:9`, `9:16`, `1:1`
`resolution`	No	e.g. `720p`, `1080p`
`duration`	No	Length in seconds
`image_url`	For image-to-video	Source image URL (upload via Media upload or any public HTTPS URL)
`video_url`	For video-to-video	Source video URL (upload via Media upload or any public HTTPS URL)

Response (202)

{
  "id": "uuid",
  "status": "pending",
  "model": "seedance-2.5/text-to-video",
  "kind": "video",
  "price_usd": 0.78
}

Poll status

GET /v1/generations/:id until status is completed or failed. When complete, the response includes output_url pointing to the hosted media file.

Webhooks

Configure a webhook URL in your dashboard to receive completion events instead of polling.

Getting started

Guides

Request body

Response (202)

Poll status

Webhooks

​Request body

​Response (202)

​Poll status

​Webhooks

Request body

Response (202)

Poll status

Webhooks