Seedance 2.5 AI Video Generator API documentation

Authenticate with Authorization: Bearer YOUR_API_KEY. Save the task identifier and query the same capability. Use a stable Idempotency-Key for submission retries.

These are public VidMage field names. The server maps them to provider fields. Input media selects the mode; use its limits together with the parameter table.

These are public VidMage field names. The server maps them to provider fields. Input media selects the mode; use its limits together with the parameter table.

These are public VidMage field names. The server maps them to provider fields. Input media selects the mode; use its limits together with the parameter table.

{
  "prompt": "A cinematic tea-garden commercial at dusk, with a slow camera drift and native audio for wind in the leaves",
  "duration": "5",
  "aspectRatio": "adaptive",
  "resolution": "720p",
  "sound": true,
  "webSearch": false,
  "returnLastFrame": false,
  "bitrateMode": "standard",
  "seed": -1,
  "outputFormat": "mp4"
}

# Set VIDMAGE_IDEMPOTENCY_KEY to a unique value for this task; preserve it for transport retries.
curl -X POST "https://vidmage.ai/api/v1/seedance-2-5-ai-video-generator/submit" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Idempotency-Key: ${VIDMAGE_IDEMPOTENCY_KEY}" \
  -H "Content-Type: application/json" \
  -d '{"prompt":"A cinematic tea-garden commercial at dusk, with a slow camera drift and native audio for wind in the leaves","duration":"5","aspectRatio":"adaptive","resolution":"720p","sound":true,"webSearch":false,"returnLastFrame":false,"bitrateMode":"standard","seed":-1,"outputFormat":"mp4"}'
# -> { "success": true, "taskId": "...", "creditsConsumed": ... }

URL of the generated video. When requested, query also returns the generated last frame as lastFrameUrl. Read videoUrl from the completed query response. Preserve taskId while the task is running.

curl -X POST "https://vidmage.ai/api/v1/seedance-2-5-ai-video-generator/query" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "taskId": "TASK_ID_FROM_SUBMIT" }'
# -> { "success": true, "data": { "status": "...", "videoUrl": "https://..." } }

Submission and task queries report the available task and usage information. A timeout is not a confirmed failure. Recover the existing task instead of resubmitting.

For face selection and error recovery, follow Task lifecycle. MCP uses the normalized taskId argument in get_task_result, including capabilities whose REST identifier is requestId.

Base charge = duration × the selected resolution rate.

Use the Playground or the MCP credit estimator for your exact inputs. Credits and billing.

Authentication · File uploads · Task lifecycle · Error recovery · MCP