Sume video 404 model_not_found: valid model ids for /v1/videos
A video request with an unknown model returns 404 model_not_found, not 400. The ids Sume accepts, how to list them, and the typos that cause it most often.

POST /v1/videos with a model that Sume does not know returns 404 model_not_found. The status is deliberate: Sume's API docs say it matches OpenRouter and every other place the platform reports an unknown model, so a client that handles one 404 handles all of them. The rule is that model must be a catalog id, a catalog alias, or sume/auto; anything else is not found.
Most 404s are a model that sounds real but is not in the catalog, not a typo. If you were expecting a vendor's newest name, check that it ships before you debug your code.
Which ids work today?
These are the catalog ids from the Video Router, which GET /v1/videos/models returns live. Copy them exactly, including the dot in wan-3.0 and gemini-omni-flash-1.1, and the hyphens in the others.
| Id | Name |
|---|---|
seedance-2.5 | Seedance 2.5 |
seedance-2 | Seedance 2.0 |
seedance-2-fast | Seedance 2.0 Fast |
seedance-2-mini | Seedance 2.0 Mini |
kling-3 | Kling Video v3 Pro |
wan-3.0 | Wan 3.0 |
grok-imagine-video-1.5 | Grok Imagine Video 1.5 |
minimax-h3 | MiniMax H3 |
minimax-h3-max | MiniMax H3 Max |
gemini-omni-flash-1.1 | Gemini Omni Flash 1.1 |
h3-max-recast | H3 Max Recast |
higgsfield-genjutsu | Higgsfield Genjutsu (listed only when its provider is configured) |
sume/auto | Sume picks the family |
What are the common causes?
Four patterns account for most of them.
- A vendor-name or version that is not in the catalog, such as a model Sume does not list; Does Sume have Veo 3.1? covers one.
- Dropping the dot or hyphen:
wan-3,wan3.0,minimax_h3andgemini-omni-flashall fail. - Using the human name from a UI, such as "Kling Video v3 Pro", as the id.
- Asking for
higgsfield-genjutsuon an environment where its provider is not configured, so the row is not listed.
How do I check before I submit?
Fetch the list once and test membership, or ask for the single row at GET /v1/video-router/models/{model_id}, which also returns 404 for an unknown id. Cache the list for the life of your process; it changes when Sume ships a model, not per request.
Do not retry a 404. It will not start working, and unlike a 5xx it carries no balance hold, so there is nothing to clean up.
Sources
Related posts
More in Developers
- Sume video callback_url must be HTTPS: a webhook instead of polling
POST /v1/videos accepts callback_url, which must be HTTPS. Event names, the signature header, retries, and when a poll loop is still the safer choice.
- Sume video job failed: retry, new key, or switch the model?
A failed video job is final, and an Idempotency-Key replay returns the same failed job. Read the error, then retry with a new key or change models.
- Sume video pricing fields: list_basis and billable_margin
How to read the pricing object on a Sume video model: per second, by resolution, or per 1,000 video tokens, and why to read billable_margin, not hard-code 1.25.
- Sume video submit 415: send JSON and pass images as URLs
POST /v1/videos answers 415 unsupported_media_type when the body is not application/json. How to read details.received_content_type and send frames as URLs.
Written by Sume