Skip to main content
POST
Localize Voice

Authorizations

Authorization
string
header
default:$CARTESIA_API_KEY
required

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

Headers

Cartesia-Version
enum<string>
default:2026-03-01
required

API version header.

Available options:
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

A description for the voice, typically longer than the tagline if both are provided.

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), Arabic (ar), Hebrew (he), Tamil (ta), Telugu (te), Thai (th).

Available options:
en,
de,
es,
fr,
ja,
pt,
zh,
hi,
it,
ko,
nl,
pl,
ru,
sv,
tr,
ar,
he,
ta,
te,
th
original_speaker_gender
enum<string>
required
Available options:
male,
female
tagline
string
default:""

A few words describing the voice. At most 32 characters.

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
access
object

Who can access the localized voice.

Response

200 - application/json
id
string
required

The ID of the voice. Find one in the Voice Library or via List Voices.

access
object
required

Who can access the voice

name
string
required

The name of the voice.

tagline
string
required

A few words describing the voice.

description
string
required

A description for the voice, typically longer than the tagline if both are provided.

created_at
string<date-time>
required

The date and time the voice was created.

language
string
required

The voice's language, as an ISO 639-1 code (e.g. en, fr, zh)

Example:

"en"

is_public
boolean
required
deprecated

Whether the voice is publicly accessible. Always false on this endpoint.

user_id
string
required
deprecated

The ID of the user who owns the voice.