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

Video preview

1. Before generating a video, prepare a few keyframes matching the user's subject, style, and aspect ratio. Reuse suitable supplied or already approved images.
2. Show the actual images through accessible links, briefly describe the intended motion, and ask the user to confirm. End the turn and wait; do not start a video job before confirmation. Revise the preview if requested.
3. After confirmation, generate the video. Use the approved images as first/last frames or references when supported by the selected model; otherwise follow the approved visual direction in the prompt. Reuse existing confirmation for an unchanged preview.

Keep the preview message short: the images, a brief motion description, and one confirmation question.

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:

jsonCopy code
{
  "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
}

bashCopy code
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:

jsonCopy code
{
  "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
}

bashCopy code
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.

bashCopy code
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:

jsonCopy code
{
  "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
}

bashCopy code
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:

jsonCopy code
{
  "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
}

bashCopy code
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.

bashCopy code
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