Update Voice | Cartesia

Path parameters

idstringRequired

The ID of the voice.

Request

This endpoint expects an object.

namestringRequired

The name of the voice.

descriptionstringRequired

The description of the voice.

Response

This endpoint returns an object.

idstring

The ID of the voice.

is_publicboolean

Whether the voice is publicly accessible.

namestring

The name of the voice.

descriptionstring

The description of the voice.

created_atdatetime

The date and time the voice was created.

embeddinglist of doubles

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

languageenum

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).

user_idstringOptional

The ID of the user who owns the voice.

1	import requests
2
3	url = "https://api.cartesia.ai/voices/id"
4
5	payload = {
6	"name": "name",
7	"description": "description"
8	}
9	headers = {
10	"Cartesia-Version": "2024-06-10",
11	"X-API-Key": "<apiKey>",
12	"Content-Type": "application/json"
13	}
14
15	response = requests.patch(url, json=payload, headers=headers)
16
17	print(response.json())

1	{
2	"id": "id",
3	"is_public": true,
4	"name": "name",
5	"description": "description",
6	"created_at": "2024-01-15T09:30:00Z",
7	"embedding": [
8	1.1,
9	1.1
10	],
11	"language": "en",
12	"user_id": "user_id"
13	}

Path parameters

Headers

Request

Response