GET
/v1/schemas/cartesia/audio/tts%2Fbytes
Accept:
Request body
10 properties · 4 required · 11 $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* | WAVOutputFormat | MP3OutputFormat | RAWO… | ||
| 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" |
| 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 |
Validate a payload
before you spend tokensshell
$ curl -X POST https://modelschemas.com/v1/validate \
-d '{"provider":"cartesia","endpointId":"tts/bytes","payload":{…}}'
→ {"valid": false, "errors": [{"path": "#", "keyword": "required", …}]}