GET

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

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

Request body

10 properties · 4 required · 11 $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*WAVOutputFormat | MP3OutputFormat | RAWO…
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"
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

Validate a payload

before you spend tokens
shell
$ curl -X POST https://modelschemas.com/v1/validate \
    -d '{"provider":"cartesia","endpointId":"tts/bytes","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}