Seedance 2.5 Global API

Pricing (flat rate)

One price per request — it does not move with the aspect ratio, the number of reference images or the length of the prompt. Charged only on success, refunded on failure.

Authentication

All requests carry the API key in the header:

Authorization: Bearer YOUR_API_KEY

Generate a video

# Text-to-video. A prompt is all it takes — length and resolution are NOT
# parameters on this tier: every clip comes back 30 seconds long at 720p.
curl -X POST https://api.apimodels.app/v1/video/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5-global",
    "prompt": "A lone cyclist on a coastal road at sunrise, long lens, slow tracking shot",
    "aspect_ratio": "16:9"
  }'

# With reference images — up to 9, as public HTTPS URLs.
# images / image_urls / reference_image_urls / image are aliases for the same list,
# so a request migrated from seedance-2.5 keeps its reference images.
curl -X POST https://api.apimodels.app/v1/video/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "seedance-2.5-global",
    "prompt": "The sneaker from the reference photos spins on a matte studio turntable, soft key light",
    "images": [
      "https://example.com/sneaker-front.jpg",
      "https://example.com/sneaker-side.jpg"
    ],
    "aspect_ratio": "9:16"
  }'

# Poll every 10-15 seconds until state == "completed";
# data.resultUrls[0] is the video. Result files are kept 7 days.
curl "https://api.apimodels.app/v1/video/generations?task_id=TASK_ID" \
  -H "Authorization: Bearer YOUR_API_KEY"

# Each of these is rejected with a 400 at create time. Nothing is quietly
# rewritten to 30s / 720p and then billed the full $2.00:
#   "duration": 10                → 30 seconds is the only length
#   "resolution": "1080p"         → 720p is the only output
#   "reference_video_urls": [...] → no video editing, no extension
#   "task_type": "edit"           → same, use seedance-2.5 instead

Parameters

These are not parameters

These are the fields a request migrated from seedance-2.5 most often still carries. This tier has no matching capability, so each one is either refused at create time or explicitly inert — none of them is accepted, quietly reshaped and billed the full $2.00 anyway.

Errors and refunds

• Returned as a synchronous 400 at create time — no task, no charge: a missing prompt or one longer than 3,000 characters; a duration other than 30; a resolution / size other than 720p; an aspect_ratio outside the six values; more than 9 reference images; a reference video, or task_type set to edit or extend.
• A failed job is refunded in full, including the case where the generated soundtrack trips the model’s own audio copyright check. A refund is not a silent clip — that take is simply gone, and the way forward is a different prompt.
• Reference images must stay reachable for the whole job. Give presigned URLs plenty of lifetime — an expired one fails the task (refunded, but the wait is wasted).
• 402 means an insufficient balance; 401 means the key is not valid.

Notes

• Async, and not fast: plan on about 6 minutes per clip. In our own testing one 30-second 720p generation finished in 369 seconds and came back as a 12.5 MB H.264 file at 1280x720, 24 fps, with a stereo AAC track. Create returns a taskId; poll GET /v1/video/generations?task_id= every 10-15 seconds until completed, or pass callback_url.
• Send them one at a time. The six minutes above is how long one clip takes, not queue time you can amortise with concurrency — this tier is not built for high concurrency, and a batch fired at once turns into a string of failures.
• It takes one aspect ratio more than seedance-2.5 does: 16:9, 9:16, 1:1, 3:4, 4:3 and 21:9, defaulting to 16:9.
• Result files are deleted after 7 days — download or re-host anything you need to keep.
• If you need a specific length, 480p, video editing or extension, real people, reference video or audio, or many jobs running at once, use seedance-2.5 instead.

Try it in the Playground