ByteDance Seedance 2.0

# 1. Submit the job. model, prompt and seconds are required. Each account may hold only a small number of
#    unfinished jobs at once — 5 by default, set per deployment — and one over that returns 429
#    video_jobs_in_flight_limit.
#
#    The model's own options go under "metadata"; every field and the values it accepts are listed below.
#    Media references go in metadata.content as {type, <type>: {url}, role}. Images and reference audio take a URL
#    or a base64 data: URI (the whole request is capped at 24 MB); reference videos must be URLs. First/last frame
#    and reference media cannot be mixed in one request.
curl "https://router-api.0g.ai/v1/videos" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <YOUR_API_KEY>" \
  -d '{
  "model": "bytedance/seedance-2.0",
  "prompt": "A cat surfing a wave at sunset",
  "seconds": 5,
  "metadata": {
    "resolution": "720p",
    "ratio": "adaptive",
    "generate_audio": true,
    "return_last_frame": true,
    "watermark": false
  }
}'

# Response: {"id": "v0_426354818031858", "status": "queued", "provider_address": "0x..."}

# 2. Poll until status is "completed". Generation takes minutes — 3-5s is a sane interval. The poll answers
#    200 and reports the job's own status, so a failure arrives as 200 + {"status":"failed"}, NOT as an error
#    code. The SUBMIT response echoes what you sent; the POLL response reports what was actually rendered — so
#    reconcile against the poll. Which fields carry that answer depends on the upstream:
#    usage.output_video_duration when the provider reported a duration, size/seconds on some providers and not
#    others. Read what is present rather than assuming a particular field.
curl "https://router-api.0g.ai/v1/videos/<VIDEO_ID>" \
  -H "Authorization: Bearer <YOUR_API_KEY>"

# 3. Download the finished file. This is where 409 / 424 / 429 live: 409 = not ready yet, 429 = too many
#    concurrent downloads (both retryable), 424 = the job failed and has no output (terminal).
curl "https://router-api.0g.ai/v1/videos/<VIDEO_ID>/content" \
  -H "Authorization: Bearer <YOUR_API_KEY>" \
  -o video.mp4