Seedance API Documentation: Models, Parameters and Errors

Quickstart

Create a bearer API key, submit an asynchronous generation task, then poll the returned local task ID until it reaches a terminal state.

curl https://api.seedanceapi.app/v1/videos/generations \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2-0",
    "prompt": "A cinematic city at sunrise",
    "duration": 5,
    "ratio": "16:9",
    "resolution": "720p",
    "generate_audio": true
  }'

Authentication

Send the API key in the HTTP Authorization header. The Public API uses bearer authentication; browser sessions are only used by the Dashboard and Playground.

Authorization: Bearer sk_live_xxx

See Get an API key for the full setup flow.

Create a task

The API validates the selected model, supported fields, numeric ranges, URLs, and cross-field combinations before calling the configured Volcano Engine China provider. A successful HTTP 200 response contains a local vid_* task ID while generation continues asynchronously.

{
  "id": "vid_01jx9w6n8e6r7x9m2p4q",
  "object": "video.generation",
  "model": "seedance-2-0",
  "status": "queued",
  "created_at": 1783900000
}

Retrieve a task

curl https://api.seedanceapi.app/v1/videos/vid_01jx9w6n8e6r7x9m2p4q \
  -H "Authorization: Bearer sk_live_xxx"

Use the same API key that created the task. Temporary provider errors return a retryable HTTP error without changing the stored task to failed.

Native content and convenience fields

You may send native content[] items or the local convenience fields such as prompt, first_frame_url, and reference URL arrays. Do not mix both formats in one request.

{
  "model": "seedance-2-0",
  "content": [
    { "type": "text", "text": "A product reveal in soft studio light" },
    {
      "type": "image_url",
      "image_url": { "url": "https://example.com/reference.jpg" },
      "role": "reference_image"
    }
  ],
  "resolution": "720p"
}

Task lifecycle

The public status is always one of these six values:

Reference

Provider and region

This service is configured for Volcano Engine China. Use the public model names shown in these docs; provider-specific model selection is handled internally.