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 classTypical output
Seedance 480pFast preview
Seedance 720pBalanced production draft
Seedance 1080pHigh-definition delivery
Seedance 4KHighest-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 classAction
Submitted / queued / processingKeep polling the same job; do not resubmit
Completed / successRead the returned media URL and download immediately
Failed / canceledRecord the failure reason and stop polling

Key parameters

ParameterGuidance
modelRequired; use the complete current Seedance model ID
promptDescribe subject, action, camera, style, and lighting
durationUse a duration supported by the selected model
image / imagesUse public HTTPS reference images when the model supports image-to-video
metadata.ratioTypical values include 16:9, 9:16, 4:3, 1:1, and 21:9
Audio and watermarkUse only when exposed by the selected model
Callback fieldsTreat callbacks as model or product specific, not a universal contract

Troubleshooting

SymptomHow to fix it
401 / 403Check the API key and whether it can access the selected Seedance model.
404Use /v1/videos/{task_id} for polling and confirm the task ID is complete.
Resolution mismatchKeep model ID and any resolution metadata consistent.
Processing takes a long timeKeep the task ID and continue polling; do not submit a duplicate.
Completed but download failedRetry the original result URL promptly before it expires.
Local image cannot be usedUpload it to an approved HTTPS location before sending it as a reference.