v1

latestOpenAPI 3.0.12026-07-2696152184.1 KB

Tts

Text-to-Speech (Bytes)

Stream audio from a complete transcript

post/tts/bytes

Headers

Cartesia-Version'2026-03-01' date required

Example:2026-03-01

API version header.

Request body

model_id'sonic-3.5' | 'sonic-3' | 'sonic-latest' required

The ID of the model to use for the generation. See Models all options.

transcriptstring required

language'en' | 'fr' | 'de' | 'es' | 'pt' | 'zh' | 'ja' | 'hi' | 'it' | 'ko' | 'nl' | 'pl' | 'ru' | 'sv' | 'tr' | 'tl' | 'bg' | 'ro' | 'ar' | 'cs' | 'el' | 'fi' | 'hr' | 'ms' | 'sk' | 'da' | 'ta' | 'uk' | 'hu' | 'no' | 'vi' | 'bn' | 'th' | 'he' | 'ka' | 'id' | 'te' | 'gu' | 'kn' | 'ml' | 'mr' | 'pa'

The language that the given voice should speak the transcript in. This may depend on the model you're using. See Models for details.

pronunciation_dict_idstring nullable

The ID of a pronunciation dictionary to use for the generation. Pronunciation dictionaries are supported by sonic-3 models and newer.

speed'slow' | 'normal' | 'fast'

This property is deprecated and may not work for all voices. Use generation_config.speed instead. Influences the speed of the generated speech.

Example request

{
  "model_id": "sonic-3.5"
}

Response

Audio bytes