> ## Documentation Index > Fetch the complete documentation index at: https://docs.cartesia.ai/llms.txt > Use this file to discover all available pages before exploring further. # Localize Voice > Create a new voice from an existing voice localized to a new language and dialect. ## OpenAPI ````yaml 2026-03-01/api.yml POST /voices/localize openapi: 3.0.1 info: title: Cartesia API version: 0.0.1 servers: - url: https://api.cartesia.ai description: Production security: [] paths: /voices/localize: post: tags: - Voices summary: Localize Voice description: >- Create a new voice from an existing voice localized to a new language and dialect. operationId: voices_localize parameters: - $ref: '#/components/parameters/CartesiaVersionHeader' requestBody: required: true content: application/json: schema: $ref: '#/components/schemas/LocalizeVoiceRequest' responses: '200': description: '' content: application/json: schema: $ref: '#/components/schemas/VoiceMetadata' security: - APIKeyAuth: [] components: parameters: CartesiaVersionHeader: name: Cartesia-Version in: header description: API version header. required: true schema: type: string format: date example: '2026-03-01' default: '2026-03-01' enum: - '2026-03-01' schemas: LocalizeVoiceRequest: type: object properties: voice_id: type: string description: The ID of the voice to localize. name: type: string description: The name of the new localized voice. tagline: type: string description: A few words describing the voice. At most 32 characters. default: '' minimum: 0 maximum: 32 description: type: string description: >- A description for the voice, typically longer than the tagline if both are provided. language: $ref: '#/components/schemas/LocalizeTargetLanguage' original_speaker_gender: $ref: '#/components/schemas/Gender' accent: allOf: - $ref: '#/components/schemas/LocalizeVoiceAccent' nullable: true description: >- 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. access: type: object description: Who can access the localized voice. properties: type: type: string enum: - private - public default: private description: |- - `private`: only your organization can use the voice - `public`: anyone can use the voice required: - type dialect: allOf: - $ref: '#/components/schemas/LocalizeDialect' nullable: true deprecated: true description: >- **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. required: - voice_id - name - description - language - original_speaker_gender example: voice_id: 0418348a-0ca2-4e90-9986-800fb8b3bbc0 name: Antoine (en) description: Antoine localized to English language: en original_speaker_gender: male VoiceMetadata: title: VoiceMetadata type: object properties: id: $ref: '#/components/schemas/VoiceId' access: type: object description: Who can access the voice properties: type: type: string enum: - private - public description: |- Who can use the voice: - `private`: only your organization can use the voice - `public`: anyone can use the voice visibility: type: string enum: - owner - all description: >- 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 required: - type - visibility name: type: string description: The name of the voice. tagline: type: string description: A few words describing the voice. description: type: string description: >- A description for the voice, typically longer than the tagline if both are provided. created_at: type: string format: date-time description: The date and time the voice was created. language: $ref: '#/components/schemas/VoiceLanguage' is_public: type: boolean description: >- Whether the voice is publicly accessible. Always false on this endpoint. deprecated: true user_id: type: string description: The ID of the user who owns the voice. deprecated: true required: - id - access - name - tagline - description - created_at - language - is_public - user_id example: 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 LocalizeTargetLanguage: title: LocalizeTargetLanguage type: string enum: - en - de - es - fr - ja - pt - zh - hi - it - ko - nl - pl - ru - sv - tr - ar - he - ta - te - th description: >- 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). Gender: title: Gender type: string enum: - male - female LocalizeVoiceAccent: title: LocalizeVoiceAccent description: Accent for the localized voice. Must be valid for the target `language`. oneOf: - title: Arabic description: Only available when language is Arabic (`ar`). type: string enum: - Modern Standard Arabic - title: Chinese description: Only available when language is Chinese (`zh`). type: string enum: - Mandarin Chinese - title: Dutch description: Only available when language is Dutch (`nl`). type: string enum: - Randstad Dutch - title: English description: Only available when language is English (`en`). type: string enum: - Australian English - British English - General American English - Indian English - Southern American English - title: French description: Only available when language is French (`fr`). type: string enum: - Canadian French - Parisian French - title: German description: Only available when language is German (`de`). type: string enum: - High German - title: Hebrew description: Only available when language is Hebrew (`he`). type: string enum: - Israeli Hebrew - title: Hindi description: Only available when language is Hindi (`hi`). type: string enum: - Hindi - title: Italian description: Only available when language is Italian (`it`). type: string enum: - Italian - title: Japanese description: Only available when language is Japanese (`ja`). type: string enum: - Japanese - title: Korean description: Only available when language is Korean (`ko`). type: string enum: - Korean - title: Polish description: Only available when language is Polish (`pl`). type: string enum: - Polish - title: Portuguese description: Only available when language is Portuguese (`pt`). type: string enum: - Brazilian Portuguese - European Portuguese - title: Russian description: Only available when language is Russian (`ru`). type: string enum: - Russian - title: Spanish description: Only available when language is Spanish (`es`). type: string enum: - Castilian Spanish - Mexican Spanish - title: Swedish description: Only available when language is Swedish (`sv`). type: string enum: - Stockholm Swedish - title: Tamil description: Only available when language is Tamil (`ta`). type: string enum: - Central Tamil - title: Telugu description: Only available when language is Telugu (`te`). type: string enum: - Telangana Telugu - title: Thai description: Only available when language is Thai (`th`). type: string enum: - Central Thai - title: Turkish description: Only available when language is Turkish (`tr`). type: string enum: - Istanbul Turkish LocalizeDialect: title: LocalizeDialect oneOf: - $ref: '#/components/schemas/LocalizeEnglishDialect' description: >- Only available when language is set to English (`en`). Options: Australian (`au`), Indian (`in`), Southern (`so`), British (`uk`), or American (`us`). - $ref: '#/components/schemas/LocalizeSpanishDialect' description: >- Only available when language is set to Spanish (`es`). Options: Latin American (`mx`) and Peninsular (`pe`). - $ref: '#/components/schemas/LocalizePortugueseDialect' description: >- Only available when language is set to Portuguese (`pt`). Options: Brazilian (`br`) and European Portuguese (`eu`). - $ref: '#/components/schemas/LocalizeFrenchDialect' description: >- Only available when language is set to French (`fr`). Options: Standard Parisian/Metropolitan (`eu`) and Canadian (`ca`). description: >- The dialect to localize to. Only supported for English (`en`), Spanish (`es`), Portuguese (`pt`), and French (`fr`). VoiceId: title: VoiceId type: string description: >- The ID of the voice. Find one in the [Voice Library](https://play.cartesia.ai/voices) or via [List Voices](/api-reference/voices/list). VoiceLanguage: type: string description: The voice's language, as an ISO 639-1 code (e.g. `en`, `fr`, `zh`) example: en LocalizeEnglishDialect: title: LocalizeEnglishDialect type: string enum: - au - in - so - uk - us LocalizeSpanishDialect: title: LocalizeSpanishDialect type: string enum: - mx - pe LocalizePortugueseDialect: title: LocalizePortugueseDialect type: string enum: - br - eu LocalizeFrenchDialect: title: LocalizeFrenchDialect type: string enum: - eu - ca securitySchemes: APIKeyAuth: type: http scheme: bearer bearerFormat: API Key description: >- Cartesia API key (`sk_car_...`). Get one at [play.cartesia.ai/keys](https://play.cartesia.ai/keys). x-default: $CARTESIA_API_KEY ````