Skip to main content
POST
Localize Voice

Authorizations

Authorization
string
header
default:$CARTESIA_API_KEY
required

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

Headers

Cartesia-Version
enum<string>
default:2026-08-14
required

API version header.

Available options:
2026-08-14
Example:

"2026-08-14"

Body

application/json

Request to localize a voice into an accent.

voice_id
string
required

ID of the existing voice you want to localize.

name
string
required

Name for the newly localized voice.

accent
required

The accent to localize into. Get ids from GET /accents with is_localizable=true.

Available options:
modern-standard-arabic
description
string

Description for the newly localized voice.

tagline
string

Short tagline for the newly localized voice.

access

Controls who can access this resource. Prefer "public" | "private". Deprecated nested { "type": "public" | "private" } is still accepted.

Available options:
private,
public

Response

200 - application/json
id
string
required

The ID of the newly created voice.

access
enum<string>
required

Who can use the resource. private means only the owner can use the resource. public means everyone can use the resource.

Available options:
private,
public
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)

Example:

"en"

user_id
string
required
deprecated

The ID of the user who owns the voice.

visibility
enum<string>
required

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.

Available options:
owner,
all