TTS

Text to Speech (SSE)

Headers

X-API-KeystringRequired
Cartesia-Version"2024-11-13"Required

Request

This endpoint expects an object.
model_idstringRequired

The ID of the model to use for the generation. See Models for available models.

transcriptstringRequired
voiceobjectRequired
output_formatobjectRequired
languageenumOptional

The language that the given voice should speak the transcript in.

Options: English (en), French (fr), German (de), Spanish (es), Portuguese (pt), Chinese (zh), Japanese (ja), Hindi (hi), Italian (it), Korean (ko), Dutch (nl), Polish (pl), Russian (ru), Swedish (sv), Turkish (tr).

durationdoubleOptional
The maximum duration of the audio in seconds. You do not usually need to specify this. If the duration is not appropriate for the length of the transcript, the output audio may be truncated.
speedenumOptional

This feature is experimental and may not work for all voices.

Speed setting for the model. Defaults to normal.

Influences the speed of the generated speech. Faster speeds may reduce hallucination rate.

Allowed values:
add_timestampsbooleanOptional

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.

add_phoneme_timestampsbooleanOptional

Whether to return phoneme-level timestamps. If false (default), no phoneme timestamps will be produced - if add_timestamps is true, the produced timestamps will be word timestamps instead. If true, the server will return timestamp events containing phoneme-level timing information.

use_normalized_timestampsbooleanOptional

Whether to use normalized timestamps (True) or original timestamps (False).

context_idstringOptional
Optional context ID for this request.

Response

This endpoint returns a stream of object.
chunkobject
OR
flush_doneobject
OR
doneobject
OR
timestampsobject
OR
errorobject
OR
phoneme_timestampsobject