GET

/v1/schemas/cartesia/audio/tts%2Fsse

kind inputactivity audiohash d0b6cf79…extracted Oct 30, 2026version currentsource upstream spec ↗

Request body

14 properties · 4 required · 9 $defs
propertytypedescriptionconstraints
model_id*enumThe 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*stringdefault: "Hi there, it's awesome to meet …
voice*TTSRequestVoiceSpecifier
output_format*SSEOutputFormat
languagestringDeprecated — 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 …
localestringThe 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…
normalizationstringControls 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_timestampsbooleanWhether 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_timestampsbooleanWhether 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_timestampsbooleanWhether to use normalized timestamps (True) or original timestamps (False).
pronunciation_dict_idstringThe ID of a pronunciation dictionary to use for the generation. Pronunciation dictionaries are supported by `sonic-3` models and newer.
generation_configGenerationConfigConfigure the various attributes of the generated speech. Available on `sonic-3` and `sonic-3.5`; not available on earlier models.
speedenumThis 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_idstringThis 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 tokens
shell
$ curl -X POST https://modelschemas.com/v1/validate \
    -d '{"provider":"cartesia","endpointId":"tts/sse","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}