TTS

Text to Speech (Bytes)

Headers

AuthorizationstringRequired

Bearer authentication of the form Bearer <token>, where token is your auth token.

Cartesia-Version"2025-04-16"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:
savebooleanOptional

Whether to save the generated audio file. When true, the response will include a Cartesia-File-ID header.

Response

This endpoint returns a file.