sume/auto for an image series: why to pin a model id instead
sume/auto never tells you which model ran, and job.model stays sume/auto. For a series that must match, send one catalog id such as google/nano-banana-2.

For a series that has to look alike, pin one catalog id instead of sume/auto. The Sume Image API page says Auto picks the family for you and never discloses which one ran: it is not listed in GET /v1/images/models, and job.model stays sume/auto. With a pinned id such as google/nano-banana-2, the model in the result is the one you asked for, and the per-image price you read from the catalog is the price you pay.
Everything here is from the Sume Image API page, read 2026-10-02.
What does sume/auto tell me back?
Little by design. The docs say model in the response echoes the id you requested, so sume/auto stays sume/auto, and upstream provider identity is not disclosed. cost is the USD amount billed to your wallet. Because the family is not named, you cannot tell from the response which model produced a given frame.
What does pinning give me?
Three things the docs spell out: the id you send is the id echoed back; GET /v1/images/models/{model_id}/endpoints shows that model's supported parameters and pricing lines; and a request that sets a parameter the model does not list returns 400 unsupported_parameter instead of being silently dropped.
| Question | sume/auto | Pinned id |
|---|---|---|
| Listed in GET /v1/images/models | No | Yes |
| job.model in the result | sume/auto | The id you sent |
| Family disclosed | Never | Yes |
| Has its own catalog row of parameters and pricing | No | Yes |
When is Auto still the right choice?
When you do not care which family renders and would rather not track the catalog: one-off drafts, internal mockups, quick tests of a prompt. For a campaign set, a comic, or product shots that sit next to each other, the docs give you no promise about which family renders each call, so the safe move is to choose.
How do I pick the id?
Call GET /v1/images/models, read supported_parameters for the features you need (references, aspect_ratio values, quality), then read the pricing line on the endpoints record. Send that id for every frame in the series, and keep the same reference image and prompt block across calls. Sume also accepts legacy bare ids such as nano-banana-2 as aliases for their org/slug equivalents, but a new integration should send the full id.
Sources
Related posts
More in Developers
- SUME_API_BASE_URL has /v1, the SDK baseUrl does not: which is right?
The Sume CLI base URL is https://api.sume.com/v1 and it sends x-api-key by default; the SDK baseUrl is https://api.sume.com with no /v1. Both env sets compared.
- SUME_CONFIG_DIR in GitHub Actions: keep Sume CLI config off the runner
Set SUME_API_KEY from a GitHub secret and SUME_CONFIG_DIR to a temp folder so the Sume CLI keeps its config off ~/.sume-com/config.json on a shared runner.
- Format run on_active_run: allow, skip or reject with a 409?
on_active_run sets what a second Format run does while one is in flight: allow runs both, skip records a skipped run, reject answers 409 format_run_in_progress.
- Sume Idempotency-Key design: one key per order and revision
Build Idempotency-Key from your own order id plus a revision number, so retries return the same Sume job and a changed prompt is a deliberate new key.
Written by Sume