Quickstart

Authentication

Pass your key in the Authorization header. API keys can be revealed from the dashboard and are matched by SHA-256 hash during authentication.

Authorization: Bearer sk_live_xxx

Create video

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

Official Seedance parameters such as callback_url, return_last_frame, service_tier, tools, safety_identifier, priority, frames, seed, camera_fixed, and watermark are passed through to the upstream provider when present.

Get video task

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

Errors

All errors use a stable envelope.

{
  "error": {
    "code": "invalid_api_key",
    "message": "The API key is invalid or revoked."
  }
}

First-version codes: missing_api_key, invalid_api_key, invalid_request, upstream_error, task_not_found, internal_error.