> ## 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 into a catalog accent. Pass a catalog accent id from GET /accents (for example `parisian` or `southern-us`). Language is derived from the accent; display names are rejected. The accent must be localizable (`is_localizable` true). ## OpenAPI ````yaml latest.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 into a catalog accent. Pass a catalog accent id from GET /accents (for example `parisian` or `southern-us`). Language is derived from the accent; display names are rejected. The accent must be localizable (`is_localizable` true). 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-08-14' default: '2026-08-14' enum: - '2026-08-14' schemas: LocalizeVoiceRequest: type: object description: Request to localize a voice into an accent. properties: voice_id: type: string description: Source voice to localize. name: type: string description: Name for the localized voice. description: type: string description: Description for the localized voice. tagline: type: string description: Optional short tagline for the localized voice. maximum: 32 accent: allOf: - $ref: '#/components/schemas/VoiceAccent' description: >- Catalog accent id from GET /accents (e.g. `southern-us` or `parisian`). Required. Display names are rejected. Language is derived from this accent. The accent must be localizable (`is_localizable` true). access: description: >- Controls who can access this resource. Prefer `"public"` | `"private"`. Deprecated nested `{ "type": "public" | "private" }` is still accepted. oneOf: - type: string enum: - private - public description: >- Set to `"public"` to let any Cartesia user with the resource ID use it, or `"private"` to restrict it to your organization. - type: object deprecated: true description: >- Deprecated. Prefer a top-level `access` string (`"public"` | `"private"`). properties: type: type: string enum: - private - public description: >- Set to `"public"` to let any Cartesia user with the resource ID use it, or `"private"` to restrict it to your organization. required: - type required: - voice_id - name - accent example: voice_id: 0418348a-0ca2-4e90-9986-800fb8b3bbc0 name: Skylar French accent: parisian access: private VoiceMetadata: title: VoiceMetadata type: object properties: id: $ref: '#/components/schemas/VoiceId' access: type: string enum: - private - public description: >- Who can use the resource. `private` means only the owner can use the resource. `public` means everyone can use the resource. 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' user_id: type: string description: The ID of the user who owns the voice. deprecated: true visibility: type: string enum: - owner - all description: >- When the resource is returned by the list endpoint. `owner` means the resource appears for the owner only. `all` means the resource appears for all users. required: - id - access - visibility - name - tagline - description - created_at - language - user_id example: id: f161df88-b5a0-4ea8-aa21-6be12859f761 access: private name: My localized voice tagline: '' description: A voice that I localized created_at: '2026-01-01T00:00:00.000Z' language: en user_id: org_123 visibility: owner VoiceAccent: title: VoiceAccent type: string description: >- Catalog accent id from GET /accents (for example `southern-us` or `parisian`). Display names are rejected on this API version. example: southern-us enum: - abruzzo-italian - african-american - african-french - arabic - arabic-english - australian - bagheli - belgian-french - brazilian-portuguese - british - budapest - bulgarian - california - camba - campania - canadian-english - canadian-french - castilian - central-tamil - central-thai - central-vietnamese - chilean - colombian - czech - danish - european-portuguese - finnish - general-american - high-german - hindi - indian-english - indian-urdu - irish - israeli - istanbul - italian - jakarta - japanese - jessore - khaleeji - konkani - korean - kyiv - malay - mandarin - manila - mexican - middle-eastern-arabic - midwestern-american - modern-standard-arabic - moldovan - new-york - new-zealand - north-kerala - odia - oslo - parisian - parsi - peruvian - polish - powadhi - randstad - romanian - russian - singaporean - slovak - south-african - southern-us - southern-karnataka - southern-vietnamese - standard-japanese - stockholm - swiss-standard - taiwanese-mandarin - tbilisi - telangana - urdu - thessaloniki - zagreb 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 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 ````