v1

latestOpenAPI 3.0.12026-07-2696152184.1 KB

Voices

Localize Voice

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

post/voices/localize

Headers

Cartesia-Version'2026-03-01' date required

Example:2026-03-01

API version header.

Request body

voice_idstring required

The ID of the voice to localize.

namestring required

The name of the new localized voice.

taglinestring

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

descriptionstring required

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

language'en' | 'de' | 'es' | 'fr' | 'ja' | 'pt' | 'zh' | 'hi' | 'it' | 'ko' | 'nl' | 'pl' | 'ru' | 'sv' | 'tr' | 'ar' | 'he' | 'ta' | 'te' | 'th' 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).

original_speaker_gender'male' | 'female' required

Example request

{
  "voice_id": "0418348a-0ca2-4e90-9986-800fb8b3bbc0",
  "name": "Antoine (en)",
  "description": "Antoine localized to English",
  "language": "en",
  "original_speaker_gender": "male"
}

Response

idstring required

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

namestring required

The name of the voice.

taglinestring required

A few words describing the voice.

descriptionstring required

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

created_atstring date-time required

The date and time the voice was created.

languagestring required

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

is_publicboolean required

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

user_idstring required

The ID of the user who owns the voice.

Example response

{
  "id": "f161df88-b5a0-4ea8-aa21-6be12859f761",
  "access": {
    "type": "private",
    "visibility": "owner"
  },
  "name": "My localized voice",
  "tagline": "",
  "description": "A voice that I localized",
  "created_at": "2026-01-01T00:00:00.000Z",
  "language": "en",
  "is_public": false,
  "user_id": "org_123"
}