Voices

Clone Voice

Clone a voice from an audio clip. This endpoint has two modes, stability and similarity.

Similarity mode clones are more similar to the source clip, but may reproduce background noise. For these, use an audio clip about 5 seconds long.

Stability mode clones are more stable, but may not sound as similar to the source clip. For these, use an audio clip 10-20 seconds long.

Headers

X-API-KeystringRequired
Cartesia-Version"2024-11-13"RequiredDefaults to 2024-11-13

Request

This endpoint expects a multipart form containing a file.
clipfileRequired

The audio clip to clone. For stability mode, the clip should be 10-20 seconds long. For similarity mode, the clip should be about 5 seconds long.

namestringRequired
The name of the voice.
descriptionstringOptional
A description for the voice.
languageenumRequired
The language of the voice.
modeenumRequired
Tradeoff between similarity and stability. Similarity clones sound more like the source clip, but may reproduce background noise. Stability clones always sound like a studio recording, but may not sound as similar to the source clip.
Allowed values:
enhancebooleanOptional
Whether to apply AI enhancements to the clip to reduce background noise. This leads to cleaner generated speech at the cost of reduced similarity to the source clip.
base_voice_idstringOptional
Optional base voice ID that the cloned voice is derived from.

Response

This endpoint returns an object.
idstring
The ID of the voice.
user_idstring
The ID of the user who owns the voice.
is_publicboolean
Whether the voice is publicly accessible.
namestring
The name of the voice.
descriptionstring
The description of the voice.
created_atdatetime
The date and time the voice was created.
languageenum

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).