Seedance Video Generation
Submit an asynchronous video job, preserve its ID, poll until completion, and download the result promptly.
Treat result URLs as temporary
Provider download links can expire. Save the task ID, continue polling the same job after interruptions, and download successful output immediately.
Choose a model
Use the exact Seedance model ID shown by OneRouter. Resolution can be encoded in the model ID or exposed as a model-specific field; keep all resolution settings consistent with the selected model.
| Example model class | Typical output |
|---|---|
| Seedance 480p | Fast preview |
| Seedance 720p | Balanced production draft |
| Seedance 1080p | High-definition delivery |
| Seedance 4K | Highest-resolution output when available |
Submit a job
Video generation is asynchronous. Submit once, store the returned job ID, and do not create a duplicate job just because processing takes longer than expected.
curl -X POST "https://onerouter.com/v1/videos" \
-H "Authorization: Bearer YOUR_ONEROUTER_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "<SEEDANCE_MODEL_ID>",
"prompt": "Locked camera, a red bicycle moves slowly across a rain-wet street",
"duration": 5,
"metadata": {
"ratio": "16:9"
}
}'Poll and download
Poll the job ID returned by the submit response. A 10-15 second interval is usually sufficient. Follow the exact status and result fields returned by the selected model because providers can differ.
curl "https://onerouter.com/v1/videos/<TASK_ID>" \
-H "Authorization: Bearer YOUR_ONEROUTER_API_KEY"Status handling
| Status class | Action |
|---|---|
| Submitted / queued / processing | Keep polling the same job; do not resubmit |
| Completed / success | Read the returned media URL and download immediately |
| Failed / canceled | Record the failure reason and stop polling |
Key parameters
| Parameter | Guidance |
|---|---|
model | Required; use the complete current Seedance model ID |
prompt | Describe subject, action, camera, style, and lighting |
duration | Use a duration supported by the selected model |
image / images | Use public HTTPS reference images when the model supports image-to-video |
metadata.ratio | Typical values include 16:9, 9:16, 4:3, 1:1, and 21:9 |
| Audio and watermark | Use only when exposed by the selected model |
| Callback fields | Treat callbacks as model or product specific, not a universal contract |
Troubleshooting
| Symptom | How to fix it |
|---|---|
| 401 / 403 | Check the API key and whether it can access the selected Seedance model. |
| 404 | Use /v1/videos/{task_id} for polling and confirm the task ID is complete. |
| Resolution mismatch | Keep model ID and any resolution metadata consistent. |
| Processing takes a long time | Keep the task ID and continue polling; do not submit a duplicate. |
| Completed but download failed | Retry the original result URL promptly before it expires. |
| Local image cannot be used | Upload it to an approved HTTPS location before sending it as a reference. |