seedance

Troubleshooting

If requests fail, run okou doctor check-connector --env-name SEEDANCE_TOKEN or okou doctor check-connector --url https://ark.ap-southeast.bytepluses.com/api/v3/contents/generations/tasks --method POST

How to Use

Video generation is asynchronous: submit a task → get a task ID → poll until succeeded → use the video URL (valid for 24 hours).

1. Text-to-Video (Standard — 1080p)

Write to /tmp/seedance_request.json:

{
  "model": "dreamina-seedance-2-0-260128",
  "content": [
    { "type": "text", "text": "A golden retriever puppy playing in autumn leaves, cinematic slow motion" }
  ],
  "resolution": "1080p",
  "ratio": "16:9",
  "duration": 5
}

curl -s -X POST "https://ark.ap-southeast.bytepluses.com/api/v3/contents/generations/tasks" --header "Authorization: Bearer $SEEDANCE_TOKEN" --header "Content-Type: application/json" -d @/tmp/seedance_request.json | jq -r '.id'

2. Text-to-Video (Fast — 720p, lower cost)

Write to /tmp/seedance_request.json:

{
  "model": "dreamina-seedance-2-0-fast-260128",
  "content": [
    { "type": "text", "text": "A timelapse of clouds rolling over mountain peaks, epic wide angle" }
  ],
  "resolution": "720p",
  "ratio": "16:9",
  "duration": 5
}

curl -s -X POST "https://ark.ap-southeast.bytepluses.com/api/v3/contents/generations/tasks" --header "Authorization: Bearer $SEEDANCE_TOKEN" --header "Content-Type: application/json" -d @/tmp/seedance_request.json | jq -r '.id'

3. Poll for Task Status

Replace <task-id> with the ID returned from the create call above.

curl -s "https://ark.ap-southeast.bytepluses.com/api/v3/contents/generations/tasks/<task-id>" --header "Authorization: Bearer $SEEDANCE_TOKEN" | jq '{status: .status, video_url: .content.video_url, duration: .duration, resolution: .resolution}'

Poll until status is succeeded. Terminal states: succeeded, failed, expired, cancelled.

4. Image-to-Video (Animate a First Frame)

Write to /tmp/seedance_request.json:

{
  "model": "dreamina-seedance-2-0-260128",
  "content": [
    {
      "type": "image_url",
      "image_url": { "url": "https://example.com/your-image.jpg" },
      "role": "first_frame"
    },
    { "type": "text", "text": "The camera slowly zooms in on the subject" }
  ],
  "resolution": "1080p",
  "ratio": "16:9",
  "duration": 5
}

curl -s -X POST "https://ark.ap-southeast.bytepluses.com/api/v3/contents/generations/tasks" --header "Authorization: Bearer $SEEDANCE_TOKEN" --header "Content-Type: application/json" -d @/tmp/seedance_request.json | jq -r '.id'

5. Reference-to-Video (Character/Style Reference)

Write to /tmp/seedance_request.json:

{
  "model": "dreamina-seedance-2-0-260128",
  "content": [
    {
      "type": "image_url",
      "image_url": { "url": "https://example.com/character.jpg" },
      "role": "reference_image"
    },
    { "type": "text", "text": "The character walks forward confidently in an urban environment" }
  ],
  "resolution": "1080p",
  "ratio": "9:16",
  "duration": 5
}

curl -s -X POST "https://ark.ap-southeast.bytepluses.com/api/v3/contents/generations/tasks" --header "Authorization: Bearer $SEEDANCE_TOKEN" --header "Content-Type: application/json" -d @/tmp/seedance_request.json | jq -r '.id'

6. Download Generated Video

Replace <video-url> with the content.video_url from the completed task.

curl -sL "<video-url>" -o /tmp/seedance_output.mp4

Model Reference

Key Parameters

Image Role Values

Guidelines

1. Video URLs expire in 24 hours — download immediately after status: succeeded
2. Async flow — always poll GET after POST; do not re-submit the same task
3. Rate limits — 3 concurrent tasks and 180 RPM for individual accounts
4. Image input — supports public URLs or Base64 (data:image/jpeg;base64,...); video input is URL only
5. No flex tier — Seedance only supports service_tier: "default"
6. Task records expire — task IDs are deleted after 7 days