Skip to main content
POST
/
voices
/
localize
Localize Voice
curl --request POST \
  --url https://api.cartesia.ai/voices/localize \
  --header 'Authorization: Bearer <token>' \
  --header 'Cartesia-Version: <cartesia-version>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "voice_id": "<string>",
  "name": "<string>",
  "description": "<string>",
  "language": "en",
  "original_speaker_gender": "male",
  "dialect": "au"
}
'
{
  "id": "<string>",
  "user_id": "<string>",
  "is_public": true,
  "name": "<string>",
  "description": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "language": "en"
}

Authorizations

​
Authorization
string
header
required

Cartesia API key (sk_car_...). Get one at play.cartesia.ai/keys.

Headers

​
Cartesia-Version
enum<string>
required

API version header.

Available options:
2024-06-10,
2024-11-13,
2025-04-16,
2026-03-01
Example:

"2026-03-01"

Body

application/json
​
voice_id
string
required

The ID of the voice to localize.

​
name
string
required

The name of the new localized voice.

​
description
string
required

The description of the new localized voice.

​
language
enum<string>
required

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

Available options:
en,
de,
es,
fr,
ja,
pt,
zh,
hi,
it,
ko,
nl,
pl,
ru,
sv,
tr
​
original_speaker_gender
enum<string>
required
Available options:
male,
female
​
dialect

Only available when language is set to English (en). Options: Australian (au), Indian (in), Southern (so), British (uk), or American (us).

Available options:
au,
in,
so,
uk,
us

Response

200 - application/json
​
id
string
required

The ID of the voice.

​
user_id
string
required

The ID of the user who owns the voice.

​
is_public
boolean
required

Whether the voice is publicly accessible.

​
name
string
required

The name of the voice.

​
description
string
required

The description of the voice.

​
created_at
string<date-time>
required

The date and time the voice was created.

​
language
enum<string>
required

The language that the given voice should speak the transcript in. For valid options, see Models.

Available options:
en,
fr,
de,
es,
pt,
zh,
ja,
hi,
it,
ko,
nl,
pl,
ru,
sv,
tr,
tl,
bg,
ro,
ar,
cs,
el,
fi,
hr,
ms,
sk,
da,
ta,
uk,
hu,
no,
vi,
bn,
th,
he,
ka,
id,
te,
gu,
kn,
ml,
mr,
pa