Skip to content
Get started

Voices

Get voices
voices.list() -> VoiceListResponse
GET/voices
Get voice by ID
voices.retrieve(strid, VoiceRetrieveParams**kwargs) -> VoiceRetrieveResponse
GET/voices/{id}
Delete a voice
voices.delete(strid) -> VoiceDeleteResponse
DELETE/voices/{id}
Generate voice preview
voices.preview(VoicePreviewParams**kwargs)
POST/voices/preview
Clone a voice
voices.clone(VoiceCloneParams**kwargs) -> VoiceCloneResponse
POST/voices/clone
ModelsExpand Collapse
class VoiceListResponse:
voices: List[Voice]
id: str

The ID of the voice.

minLength1
description: str

The description of the voice.

language: Literal["en", "fr", "es", 5 more]

The language of the voice.

One of the following:
"en"
"fr"
"es"
"de"
"it"
"pt"
"ru"
"zh"
name: str

The name of the voice.

provider: Literal["cartesia", "elevenlabs", "gradium"]

The provider of the voice.

One of the following:
"cartesia"
"elevenlabs"
"gradium"
accent: Optional[str]

The accent/dialect of the voice (e.g. ‘american’, ‘british’, ‘australian’, ‘quebec’).

gender: Optional[str]

The gender of the voice (e.g. ‘male’, ‘female’, ‘neutral’).

is_cloned: Optional[bool]

Whether this is a cloned voice.

model_compat: Optional[Literal["universal", "sonic-3", "sonic-3.5", "sonic-3.6"]]

Cartesia model compatibility. Used to filter the voice list by the selected model. Absent/undefined is treated as ‘universal’.

One of the following:
"universal"
"sonic-3"
"sonic-3.5"
"sonic-3.6"
class VoiceRetrieveResponse:
voice: Voice
id: str
name: str
description: Optional[str]
class VoiceDeleteResponse:
success: bool
class VoiceCloneResponse:
id: str
cartesia_voice_id: str
created_at: str
language: str
name: str