Skip to main content
POST
/
voices
Create Voice
curl --request POST \
  --url https://api.cartesia.ai/voices \
  --header 'Cartesia-Version: <cartesia-version>' \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '{
  "name": "<string>",
  "description": "<string>",
  "embedding": [
    123
  ],
  "language": "en",
  "base_voice_id": "<string>"
}'
{
  "id": "<string>",
  "is_owner": true,
  "name": "<string>",
  "description": "<string>",
  "created_at": "2023-11-07T05:31:56Z",
  "embedding": [
    123
  ],
  "is_starred": true,
  "language": "en"
}

Authorizations

​
X-API-Key
string
header
required

Headers

​
Cartesia-Version
enum<string>
required

API version header. Must be set to the API version, e.g. '2024-06-10'.

Available options:
2024-06-10,
2024-11-13,
2025-04-16
Example:

"2024-11-13"

Body

application/json
​
name
string
required

The name of the voice.

​
description
string
required

The description of the voice.

​
embedding
number[]
required

A 192-dimensional vector (i.e. a list of 192 numbers) that represents the voice.

​
language
enum<string>

The language that the given voice should speak the transcript in.

Options: English (en), French (fr), German (de), Spanish (es), Portuguese (pt), Chinese (zh), Japanese (ja), Hindi (hi), Italian (it), Korean (ko), Dutch (nl), Polish (pl), Russian (ru), Swedish (sv), Turkish (tr).

Available options:
en,
fr,
de,
es,
pt,
zh,
ja,
hi,
it,
ko,
nl,
pl,
ru,
sv,
tr
​
base_voice_id
string

The ID of the voice.

Response

200 - application/json
​
id
string
required

The ID of the voice.

​
is_owner
boolean
required

Whether the current user is the owner of the voice.

​
name
string
required

The name of the voice.

​
description
string
required

The description of the voice.

​
created_at
string<date-time>
required

The date and time the voice was created.

​
language
enum<string>
required

The language that the given voice should speak the transcript in.

Options: English (en), French (fr), German (de), Spanish (es), Portuguese (pt), Chinese (zh), Japanese (ja), Hindi (hi), Italian (it), Korean (ko), Dutch (nl), Polish (pl), Russian (ru), Swedish (sv), Turkish (tr).

Available options:
en,
fr,
de,
es,
pt,
zh,
ja,
hi,
it,
ko,
nl,
pl,
ru,
sv,
tr
​
embedding
number[]

The vector embedding of the voice. Only included when expand includes embedding.

​
is_starred
boolean | null

Whether the current user has starred the voice. Only included when expand includes is_starred.