---
title: "Localize Voice"
method: POST
path: "/voices/localize"
tags: ["Voices"]
---

# Localize Voice

`POST /voices/localize`

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

## Headers

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

## Request body

- LocalizeVoiceRequest
  - `voice_id` string, required — The ID of the voice to localize.
  - `name` string, required — The name of the new localized voice.
  - `tagline` string — A few words describing the voice. At most 32 characters.
  - `description` string, 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
  - `dialect` union — The dialect to localize to. Only supported for English (`en`), Spanish (`es`), Portuguese (`pt`), and French (`fr`).
    - 'au' | 'in' | 'so' | 'uk' | 'us'
    - 'mx' | 'pe'
    - 'br' | 'eu'
    - 'eu' | 'ca'
  - `access` object — Who can access the localized voice.
    - `type` 'private' | 'public', required — - `private`: only your organization can use the voice - `public`: anyone can use the voice

## Response `200`

- VoiceMetadata
  - `id` string, required — The ID of the voice. Find one in the [Voice Library](https://play.cartesia.ai/voices) or via [List Voices](/api-reference/voices/list).
  - `access` object, required — Who can access the voice
    - `type` 'private' | 'public', required — Who can use the voice: - `private`: only your organization can use the voice - `public`: anyone can use the voice
    - `visibility` 'owner' | 'all', required — Who sees the voice when using the [list endpoint](/api-reference/voices/list): - `owner`: only your organization sees the voice listed - `all`: all users see the voice listed
  - `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`)
  - `is_public` boolean, required — Whether the voice is publicly accessible. Always false on this endpoint.
  - `user_id` string, required — The ID of the user who owns the voice.

---

[API](https://skmtc.net/cartesia/apis/cartesia-api.md) · [All operations](https://skmtc.net/cartesia/apis/cartesia-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cartesia/cartesia-api/revisions/8910812440d3/schema)