Seedance 2.5 · Generate video

Endpoint	Method	Path
Submit task	POST	/v1/videos/generations
Query result	GET	/v1/videos/generations/{id}

Request parameters

Authorization

Add an Authorization header whose value is Bearer followed by your API key.

Authorization: Bearer ****************

Header parameters

Content-TypestringOptional

application/json

AcceptstringOptional

application/json

Body parametersapplication/jsonrequired

modelstringRequired

Model ID, fixed to `dreamina-seedance-2.5`

contentarray[object]Required

BytePlus native input array (recommended primary usage); combine the 5 types below. Note that role sits at the content-item level alongside type, NOT inside the image_url/video_url sub-object. Roles: image first_frame/last_frame/reference_image; video reference_video.

callback_urlstringOptional

Callback URL notified on task status change (optional)

return_last_framebooleanOptional

Whether to return the last-frame image (default false)

resolutionstringOptional

480p / 720p / 1080p / 4kVideo resolution (default 720p; 4k only on Seedance 2.0)

ratiostringOptional

16:9 / 4:3 / 1:1 / 9:16 / 21:9 / adaptiveAspect ratio of the generated video (default adaptive)

durationintegerOptional

Video duration in seconds (default 5)

seedintegerOptional

Random seed, default -1 (random); range [-1, 2^32-1]

camera_fixedbooleanOptional

Whether the camera is fixed (default false)

watermarkbooleanOptional

Whether to add a watermark (default false)

service_tierstringOptional

default / flexService tier: default (online inference) / flex (offline, half price; unsupported on Seedance 2.0)

execution_expires_afterintegerOptional

Task timeout (seconds) from created_at; default 172800 (48h), range [3600, 259200]

generate_audiobooleanOptional

Whether the output includes synchronized audio (default true; Seedance 2.0 / 1.5 Pro only)

draftbooleanOptional

Enable draft mode (default false; Seedance 1.5 Pro only; draft fixed at 480p)

safety_identifierstringOptional

Unique end-user identifier for platform risk detection

Example

{
  "model": "dreamina-seedance-2.5",
  "content": [
    {
      "type": "text",
      "text": "Slow-motion waves hitting rocks, warm dusk tones"
    }
  ],
  "resolution": "720p",
  "ratio": "16:9",
  "duration": 5,
  "seed": 11,
  "camera_fixed": false,
  "watermark": false
}

{  "model": "dreamina-seedance-2.5",  "content": [    {      "type": "text",      "text": "Slow-motion waves hitting rocks, warm dusk tones"    }  ],  "resolution": "720p",  "ratio": "16:9",  "duration": 5,  "seed": 11,  "camera_fixed": false,  "watermark": false}

Request code samples

curl https://api.hotrouter.ai/v1/videos/generations \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "dreamina-seedance-2.5",
    "content": [
      {
        "type": "text",
        "text": "Slow-motion waves hitting rocks, warm dusk tones"
      }
    ],
    "resolution": "720p",
    "ratio": "16:9",
    "duration": 5,
    "seed": 11,
    "camera_fixed": false,
    "watermark": false
  }'

curl https://api.hotrouter.ai/v1/videos/generations \  -H "Authorization: Bearer $API_KEY" \  -H "Content-Type: application/json" \  -d '{    "model": "dreamina-seedance-2.5",    "content": [      {        "type": "text",        "text": "Slow-motion waves hitting rocks, warm dusk tones"      }    ],    "resolution": "720p",    "ratio": "16:9",    "duration": 5,    "seed": 11,    "camera_fixed": false,    "watermark": false  }'

Response

Submit task

{
  "id": "cgt-xxxxxxxx",
  "status": "queued"
}

{  "id": "cgt-xxxxxxxx",  "status": "queued"}

Query result

{
  "id": "cgt-xxxxxxxx",
  "status": "succeeded",
  "content": {
    "video_url": "https://.../video.mp4"
  },
  "usage": {
    "completion_tokens": 0
  }
}

{  "id": "cgt-xxxxxxxx",  "status": "succeeded",  "content": {    "video_url": "https://.../video.mp4"  },  "usage": {    "completion_tokens": 0  }}

Seedance 2.5 · Generate video

Request parameters

Request code samples

Response

On this page