Skip to main content
POST
Localize Voice

承認

Authorization
string
header
デフォルト:$CARTESIA_API_KEY
必須

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

ヘッダー

Cartesia-Version
enum<string>
デフォルト:2026-03-01
必須

API version header.

利用可能なオプション:
2026-03-01
:

"2026-03-01"

ボディ

application/json
voice_id
string
必須

The ID of the voice to localize.

name
string
必須

The name of the new localized voice.

description
string
必須

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

language
enum<string>
必須

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

利用可能なオプション:
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>
必須
利用可能なオプション:
male,
female
tagline
string
デフォルト:""

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

accent

Accent for the localized voice. Must be valid for language.

This is a subset of the accents a voice can be tagged with: it lists only the accents localization can render. Omit to use the default accent for the language.

利用可能なオプション:
Modern Standard Arabic
access
object

Who can access the localized voice.

dialect
非推奨

Deprecated — use accent instead. accent covers every localizable language, while dialect is only supported for English (en), Spanish (es), Portuguese (pt), and French (fr).

To migrate, send the equivalent accent: Australian (au) → Australian English, British (uk) → British English, Indian (in) → Indian English, Southern (so) → Southern American English, American (us) → General American English, Latin American (mx) → Mexican Spanish, Peninsular (pe) → Castilian Spanish, Brazilian (br) → Brazilian Portuguese, European Portuguese (eu) → European Portuguese, Canadian (ca) → Canadian French, and Parisian/Metropolitan (eu) → Parisian French.

利用可能なオプション:
au,
in,
so,
uk,
us

レスポンス

200 - application/json
id
string
必須

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

access
object
必須

Who can access the voice

name
string
必須

The name of the voice.

tagline
string
必須

A few words describing the voice.

description
string
必須

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

created_at
string<date-time>
必須

The date and time the voice was created.

language
string
必須

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

:

"en"

is_public
boolean
必須
非推奨

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

user_id
string
必須
非推奨

The ID of the user who owns the voice.