How do I know a new TTS model is available on Sume?
Every week brings a new voice model. The live answer is one GET request: list the TTS Router catalog. What an unknown id returns, and how to avoid hard-coding.

How can you tell whether a newly launched TTS model works on Sume? Call GET /v1/tts-router/models. If the id is not in that list, a request with it returns 400 model_not_found. Blog posts and launch threads, including this one, go stale; the endpoint does not.
In the last few weeks Microsoft released MAI-Voice-2.1, ElevenLabs released Eleven v4 and Mistral released Voxtral TTS (all read 2026-10-04). The Sume router catalog documented in the API contract at the time of reading lists Sonic versions only, so none of those three is selectable there.
Read the catalog
The response is a list of model ids with the capabilities each supports. Fetch it at startup or on a schedule instead of copying ids into code.
import os, requests
r = requests.get("https://api.sume.com/v1/tts-router/models",
headers={"Authorization": "Bearer " + os.environ["SUME_API_KEY"]})
r.raise_for_status()
j = r.json()
print(j.get("data", j))
What the contract says about ids
These rules come from the OpenAPI contract behind the API reference.
| Situation | Result |
|---|---|
model omitted on the router | Request rejected; model is required |
model sent to TTS 1.0 | 400; that endpoint takes no model field |
| Unknown id | 400 model_not_found |
sonic-latest | Alias for the current newest Sonic, so it can change over time |
sonic-preview with a pro voice clone | Fails with voice_model_mismatch |
Keep your integration calm
Pin concrete ids in production, and use the catalog to alert when a new one appears so a person can audition it. Treat an alias such as sonic-latest as a convenience for experiments only, because its meaning moves.
If you need a model that is not listed, the honest answer is that Sume does not offer it yet; use that vendor's own API for that voice, and keep Sume for the parts the voice feeds, such as captions, timelines and avatars.
Sources
Related posts
More in Developers
- How long AI video vendors keep your file: Veo 2 days, Higgsfield 7+
Veo keeps videos two days, Higgsfield files at least seven, Sora Batch outputs were kept 24 hours. Retention facts and a download-on-complete script.
- How many image models does Sume list? Count them with a script
Sume's image catalog lists 19 ids plus sume/auto. Count text-only versus edit-capable rows live from the API instead of trusting a number in a blog post.
- How to get an AI video generation API key: Sume steps and gotchas
Create a workspace API key in the Sume dashboard, send it as one header, check it with GET /v1/me, and keep it on your server. Scopes are fixed at creation.
- Idempotency keys for batch TTS: derive them from what you render
A retry loop that mints random keys pays twice. Hash the sentence, voice, model and settings into the key, and re-running a script returns the first job.
Written by Sume