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`: ```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 } ``` ```bash 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`: ```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 } ``` ```bash 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. ```bash 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`: ```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 } ``` ```bash 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`: ```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 } ``` ```bash 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. ```bash curl -sL "<video-url>" -o /tmp/seedance_output.mp4 ``` ## Model Reference | Model ID | Tier | Max Resolution | Duration | |---|---|---|---| | `dreamina-seedance-2-0-260128` | Standard | 1080p | 4–15s or `-1` (smart) | | `dreamina-seedance-2-0-fast-260128` | Fast | 720p | 4–15s or `-1` (smart) | ## Key Parameters | Parameter | Values | Default | Description | |---|---|---|---| | `resolution` | `480p`, `720p`, `1080p` | `720p` | Output resolution | | `ratio` | `16:9`, `4:3`, `1:1`, `3:4`, `9:16`, `21:9`, `adaptive` | `adaptive` | Aspect ratio | | `duration` | `4`–`15` or `-1` | `5` | Duration in seconds; `-1` = smart auto | | `generate_audio` | `true`/`false` | `true` | Include AI-generated audio | | `seed` | integer | `-1` | Fixed seed for reproducibility; `-1` = random | | `watermark` | `true`/`false` | `false` | Add watermark to output | | `return_last_frame` | `true`/`false` | `false` | Also return the last frame as a PNG URL | ## Image Role Values | Role | Description | |---|---| | `first_frame` | Image used as the first frame of the video | | `last_frame` | Image used as the last frame of the video | | `reference_image` | Character/style reference (up to 9 images) | | `reference_video` | Video style reference (up to 3 videos, URL only — no Base64) | | `reference_audio` | Audio reference (up to 3 clips) | ## 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