Skip to main content
PATCH
Add Voice Accents

承認

Authorization
string
header
デフォルト:$CARTESIA_API_KEY
必須

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

ヘッダー

Cartesia-Version
enum<string>
デフォルト:2026-08-14
必須

API version header.

利用可能なオプション:
2026-08-14
:

"2026-08-14"

パスパラメータ

id
string
必須

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

ボディ

application/json
accents
enum<string>[]
必須

Accents to add. A voice can support up to 10 accents in total, including native.

Required array length: 1 - 9 elements
利用可能なオプション:
australian,
brazilian-portuguese,
british,
canadian-french,
castilian,
central-tamil,
central-thai,
general-american,
high-german,
hindi,
israeli,
istanbul,
italian,
japanese,
korean,
mandarin,
mexican,
modern-standard-arabic,
parisian,
polish,
randstad,
russian,
southern-us,
stockholm,
telangana
:

レスポンス

200 - application/json

The same voice ID that can now speak the newly added accent(s).

id
string
必須

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

is_owner
boolean
必須

Whether your organization owns the voice.

access
enum<string>
必須

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

利用可能なオプション:
private,
public
name
string
必須

The display name of the voice. Does not include the tagline.

tagline
string
デフォルト:""
必須

A short descriptor for the voice (at most 32 characters). Empty string when unset.

description
string
必須

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

created_at
string<date-time>
必須

The date and time the voice was created.

language
string
必須
非推奨

Deprecated. Prefer accents[].locale (BCP-47). ISO 639-1 language code (e.g. en, fr, zh).

:

"en"

visibility
enum<string>
必須

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.

利用可能なオプション:
owner,
all
gender
enum<string> | null

The gender of the voice, if specified.

利用可能なオプション:
masculine,
feminine,
gender_neutral
preview_file_url
string | null

A URL to download a preview audio file for this voice. Useful to avoid consuming credits when looking for the right voice. The URL requires the same Authorization header. Voice previews may be changed, moved, or deleted so you should avoid storing the URL permanently. This property will be null if there's no preview available. Only included when expand[] includes preview_file_url.

accents
VoiceAccentsItem · object[]

Accents supported by this voice. The accent with is_native: true is the voice's original accent. Only available for voices with known accent information.

:
country
string | null
非推奨

Deprecated. Prefer accents[].locale (BCP-47). ISO 3166-1 alpha-2 country code when available (e.g. US, GB, FR).

:

"US"

is_pro
boolean

Whether this voice is a pro voice clone.