model sume/auto on /v1/videos vs pinning Seedance 2.5: what differs
sume/auto lets Sume pick the video family and never says which. Its documented limits are 3 to 10 s, so a 15 or 30 second Seedance clip must be pinned.

Use sume/auto when you want a clip and do not care which model makes it; pin seedance-2.5 when you need its 4 to 30 second range, a specific resolution grid or a price you can compute in advance. The docs say the Auto create controls default to 720p and 8 s, with 3 to 10 s clips at 16:9 or 9:16, and that Sume never discloses which family served the request (Video generation).
Side by side
| sume/auto | seedance-2.5 | |
|---|---|---|
| Chooses the model | Sume | You |
| Documented defaults | 720p, 8 s | set in the request |
| Duration | 3-10 s | 4-30 s |
| Aspect ratios | 16:9 or 9:16 | 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 |
| Receipt shows | sume/auto | seedance-2.5 |
| Price, 8 s 720p | resolved by Sume from the request | $4.6224 |
Auto request
The request omits resolution and lets Sume apply its defaults. A replay with the same Idempotency-Key gets the same route and price.
curl -X POST https://api.sume.com/v1/videos \
-H "Authorization: Bearer $SUME_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: auto-001" \
-d '{
"model": "sume/auto",
"prompt": "A vertical UGC-style product clip on a desk, natural light",
"aspect_ratio": "9:16",
"duration": 5
}'Which to use
- Exploration and short clips: sume/auto.
- 15 to 30 seconds in one job: pin seedance-2.5.
- Repeatable per-model budgets: pin an id, because you can compute its price.
- Do not infer the served family from the output; Sume says to avoid that.
Pricing a pinned run
With a pinned id you can price the job before sending it. An 8-second 720p Seedance 2.5 clip at 9:16 is $4.6224, and a 30-second one is $17.334 at 720p. With sume/auto the route and price are resolved from the normalized request and the catalog version, so a replay with the same idempotency key lands on the same route and the same price; the first request is the only place the price is unknown to you in advance.
The older /v1/video-router/* endpoints still work and create the same jobs, but the docs recommend sume/auto on POST /v1/videos for new integrations.
Sources
Related posts
More in Developers
- Cancel a Sume bulk run: no queue endpoint, so cancel each child
Sume has no public cancel for a bulk queue. Poll the queue, then POST /v1/format-runs/{run_id}/cancel for each running child. fal cancels one request with PUT.
- Resume a bulk run after a crash: replay the Idempotency-Key
If your client dies after POSTing a 100-item bulk run, replay the same key and same body: Sume returns 202 with the original queue. A new body gets 409.
- Sume Image API 400 unsupported_parameter: which field fails where
Which Sume image models list quality, resolution, mask_url, background, output_format and references, and which never do (seed, stream). Plus a check script.
- result_ready vs terminal vs completed: gate the Sume result fetch
Poll a Sume job until terminal, fetch the result only when result_ready is true. Failed and canceled jobs answer 409 job_not_completed on /result.
Written by Sume