Localize Voice | Cartesia

1 import requests 2 3 url = "https://api.cartesia.ai/voices/localize" 4 5 payload = { 6 "voice_id": "694f9389-aac1-45b6-b726-9d9369183238", 7 "name": "Sarah Peninsular Spanish", 8 "description": "Sarah Voice in Peninsular Spanish", 9 "language": "es", 10 "original_speaker_gender": "female", 11 "dialect": "pe" 12 } 13 headers = { 14 "Cartesia-Version": "2025-04-16", 15 "Authorization": "Bearer <token>", 16 "Content-Type": "application/json" 17 } 18 19 response = requests.post(url, json=payload, headers=headers) 20 21 print(response.json())

1 { 2 "id": "8f7d3c2e-1a2b-3c4d-5e6f-7g8h9i0j1k2l", 3 "user_id": "user_id", 4 "is_public": false, 5 "name": "Sarah Peninsular Spanish", 6 "description": "Sarah Voice in Peninsular Spanish", 7 "created_at": "2024-03-15T10:30:00.000Z", 8 "language": "es" 9 }

Create a new voice from an existing voice localized to a new language and dialect.

Request

This endpoint expects an object.

voice_idstringRequired

The ID of the voice to localize.

namestringRequired

The name of the new localized voice.

descriptionstringRequired

The description of the new localized voice.

languageenumRequired

Target language to localize the voice to.

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

original_speaker_genderenumRequired

Allowed values:

dialectenumOptional

The dialect to localize to. Only supported for English (en), Spanish (es), Portuguese (pt), and French (fr).

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

Headers

Request

Response