GET
/v1/schemas/cartesia/audio/tts%2Fsse
Accept:
Request body
14 properties · 4 required · 9 $defs| property | type | description | constraints |
|---|---|---|---|
| model_id* | enum | The ID of the model to use for the generation. See [Models](/build-with-cartesia/tts-models/latest) all options. | sonic-3.5 | sonic-3 | sonic-preview | sonic-latest · default: "sonic-3.5" |
| transcript* | string | default: "Hi there, it's awesome to meet … | |
| voice* | TTSRequestVoiceSpecifier | ||
| output_format* | SSEOutputFormat | ||
| language | string | Deprecated — use `locale` instead on Sonic 3.6 and later. The language the voice speaks the transcript in, as a code from the languages the model supports (`en`, `hi`). Supported languages are model-specific. See the language support section for the model you … | |
| locale | string | The locale or language the voice speaks the transcript in, as a code from the [supported locales](/build-with-cartesia/capability-guides/advanced-capabilities#which-locales-are-supported) or the languages the model supports (`en-GB`, `hi-IN`, `en`, `hi`). Acce… | |
| normalization | string | Controls how written forms (dates, times, numbers) are converted to spoken forms, independently of the voice's accent. One of `auto` (default), `off`, or a locale code from the [supported locales](/build-with-cartesia/capability-guides/advanced-capabilities#wh… | default: "auto" |
| add_timestamps | boolean | Whether to return word-level timestamps. If `false` (default), no word timestamps will be produced at all. If `true`, the server will return timestamp events containing word-level timing information. | default: false |
| add_phoneme_timestamps | boolean | Whether to return phoneme-level timestamps. If `false` (default), no phoneme timestamps will be produced. If `true`, the server will return timestamp events containing phoneme-level timing information. | default: false |
| use_normalized_timestamps | boolean | Whether to use normalized timestamps (True) or original timestamps (False). | |
| pronunciation_dict_id | string | The ID of a pronunciation dictionary to use for the generation. Pronunciation dictionaries are supported by `sonic-3` models and newer. | |
| generation_config | GenerationConfig | Configure the various attributes of the generated speech. Available on `sonic-3` and `sonic-3.5`; not available on earlier models. | |
| speed | enum | This property is deprecated and may not work for all voices. Use `generation_config.speed` instead. Influences the speed of the generated speech. | slow | normal | fast · default: "normal" · deprecated |
| context_id | string | This can be any string value you find useful. The server will echo back the same `context_id` in events that it sends. > Contexts on the [TTS (WebSocket)](/api-reference/tts/websocket) endpoint are used for [continuations](/build-with-cartesia/capability-guide… |
Validate a payload
before you spend tokensshell
$ curl -X POST https://modelschemas.com/v1/validate \
-d '{"provider":"cartesia","endpointId":"tts/sse","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}