Documentation Index
Fetch the complete documentation index at: https://docs.cartesia.ai/llms.txt
Use this file to discover all available pages before exploring further.
Starting June 1, 2026, we are discontinuing several models, snapshots, and languages, and removing voice embeddings from our voice API. Migrate to sonic-3.5 for improved naturalness, 42-language support, and fine-grained controls.
Deprecated models and languages
You can check if you’re making requests to deprecated models on play.cartesia.ai/deprecation/traffic.
Fully deprecated models
These models will stop serving requests on June 1, 2026.
| Model | Snapshots affected | Deprecated languages |
|---|
sonic | All | All |
sonic-english | — | All |
sonic-multilingual | — | All |
sonic-2 | sonic-2-2025-03-07 | All |
sonic-turbo | sonic-turbo-2025-03-07 | All |
Partially deprecated models
These models will continue to serve a reduced set of languages. The languages listed below will be discontinued on June 1, 2026.
| Model | Snapshots affected | Deprecated languages |
|---|
sonic-2 | sonic-2-2025-04-16, sonic-2-2025-05-08, sonic-2-2025-06-11 | it, nl, pl, ru, sv, tr, hi |
sonic-turbo | sonic-turbo-2025-06-04 | it, nl, pl, ru, sv, tr |
Stable offerings
The following will remain available beyond June 1.
| Model | Snapshots | Supported Languages |
|---|
sonic-3 | All | 42 languages — full list |
sonic-2 | sonic-2-2025-04-16, sonic-2-2025-05-08, sonic-2-2025-06-11 | en, de, es, fr, ja, ko, pt, zh |
sonic-turbo | sonic-turbo-2025-06-04 | en, de, es, fr, ja, ko, pt, zh, hi |
API changes
These endpoints will be discontinued on June 1, 2026.
| Discontinued Endpoint | Replacement |
|---|
Voice Embedding: POST /voices/clone/clip | Clone Voice |
Mix Voices: POST /voices/mix | — |
Create Voice: POST /voices | Clone Voice |
| Endpoint with a breaking change | Replacement |
|---|
TTS (bytes): POST /tts/bytes | Voice IDs |
TTS (SSE): POST /tts/sse | Voice IDs |
TTS (WebSocket): WSS /tts/websocket | Voice IDs |
2026-03-01. We recommend upgrading your Cartesia Version on production traffic before June 1 to make sure nothing breaks.
Moving off of deprecated endpoints
- Change how you create voices — see Migrating Voices.
- Switch from voice embeddings to IDs — see Voice IDs.
Full Checklist
- Move off of deprecated models / snapshots / languages onto
sonic-3.5 or another stable model
- Move off of deprecated endpoints when creating voices
- Use Voice IDs
- Check your deprecated model traffic on play.cartesia.ai/deprecation/traffic
- Make sure your voices are migrated on play.cartesia.ai/deprecation/voices
- (Optional) Upgrade your Cartesia Version to
2026-03-01
Why are we doing this?
Since the launch of Sonic 3, we’ve made improvements across pacing, prosody, and naturalness; the vast majority of our customers have migrated to these models with great success. In order to increase our capacity, availability, and serving performance, we have to discontinue our oldest models.
Additionally, our newer models have evolved beyond voice embeddings in order to sound more natural. The parts of our API that accept voice embeddings cannot be made forward-compatible. Migrating to voice IDs will allow us to continue to improve both our models and your voices in tandem.
If you have questions, reach out to support@cartesia.ai.
