List Voices

GET

List all voices available to the user, that is, public voices and the user’s own voices.

Headers

Auth

X-API-KeystringRequired

Cartesia-VersionstringRequired

The version of the Cartesia API to use.

Response

This endpoint returns a list of objects.

idstring

user_idstring

is_publicboolean

namestring

descriptionstring

created_atstring

embeddinglist of doubles

base_voice_idstringOptional

GET

1 curl https://api.cartesia.ai/voices \
2      -H "Cartesia-Version: 2024-06-10" \
3      -H "X-API-Key: <apiKey>"

200Retrieved

1 [
2   {
3     "id": "a0e99841-438c-4a64-b679-ae501e7d6091",
4     "user_id": "user_id",
5     "is_public": true,
6     "name": "Barbershop Man",
7     "description": "A deep, rich, male voice with an Indian accent.",
8     "created_at": "created_at",
9     "embedding": [
10       -0.033633083,
11       0.072083704,
12       -0.01807767,
13       -0.083488315,
14       -0.04407617,
15       0.0022592682,
16       0.070505895,
17       0.023946615,
18       -0.04788024,
19       -0.06388413,
20       -0.0716355,
21       -0.0022612812,
22       -0.0053448505,
23       -0.07848381,
24       0.0348162,
25       -0.053745482,
26       -0.092399485,
27       -0.02950225,
28       0.028591828,
29       -0.10556894,
30       0.023313355,
31       0.06224387,
32       0.0362463,
33       0.029258432,
34       0.10769641,
35       0.043595582,
36       -0.058543224,
37       -0.080402784,
38       -0.0953816,
39       -0.008988032,
40       -0.0028981369,
41       -0.004752721,
42       -0.20742874,
43       0.058907595,
44       0.08813939,
45       -0.06192675,
46       0.099082634,
47       -0.09661578,
48       -0.0077761724,
49       -0.013982456,
50       -0.025798267,
51       0.04467142,
52       0.026222011,
53       0.023023574,
54       0.011227064,
55       -0.17462021,
56       -0.09880612,
57       -0.1521035,
58       -0.060464993,
59       -0.04735665,
60       -0.09725187,
61       -0.006127679,
62       0.15818526,
63       -0.039493002,
64       -0.067719474,
65       0.0066190436,
66       -0.10636633,
67       0.17073768,
68       -0.051717706,
69       0.03186961,
70       -0.020547207,
71       -0.02244247,
72       0.013196935,
73       -0.06431055,
74       -0.115360335,
75       0.016918058,
76       -0.033195216,
77       0.11255181,
78       0.020366343,
79       -0.041032124,
80       0.08780918,
81       -0.040567942,
82       0.057276532,
83       0.05848221,
84       -0.077479474,
85       -0.073524915,
86       -0.01913317,
87       -0.029291833,
88       0.11210393,
89       -0.09859328,
90       0.2152541,
91       -0.022976823,
92       0.028627992,
93       -0.039598297,
94       0.041829932,
95       -0.05593181,
96       -0.06444655,
97       -0.018057477,
98       -0.008098263,
99       0.05994528,
100       0.10430693,
101       -0.13121894,
102       -0.06512868,
103       -0.026126215,
104       0.046727825,
105       -0.17180993,
106       -0.10577226,
107       -0.08610466,
108       0.008862588,
109       0.09547498,
110       -0.010965332,
111       -0.061217085,
112       -0.038954042,
113       0.019930292,
114       -0.017192135,
115       0.007296275,
116       0.03273872,
117       0.04389937,
118       -0.056483064,
119       0.003420891,
120       -0.10319067,
121       -0.015706042,
122       0.1308774,
123       -0.0018035866,
124       -0.03582506,
125       0.077131025,
126       0.013398928,
127       0.003188886,
128       0.12039741,
129       -0.033974767,
130       0.06899378,
131       -0.059775922,
132       -0.026934423,
133       0.028482193,
134       0.100996524,
135       0.004498743,
136       -0.02291186,
137       0.078752205,
138       -0.0063796206,
139       0.04206536,
140       0.05721349,
141       0.06290694,
142       0.06130212,
143       0.096969016,
144       -0.057664312,
145       -0.16727506,
146       -0.035220966,
147       0.090760484,
148       0.010039947,
149       0.06513242,
150       0.011055657,
151       -0.004258431,
152       -0.08316792,
153       -0.15650468,
154       -0.076931365,
155       0.11385587,
156       -0.038372636,
157       0.015648656,
158       -0.12029895,
159       -0.06604956,
160       0.009441591,
161       -0.11912808,
162       0.013378132,
163       0.029525978,
164       -0.0056742397,
165       -0.0075976513,
166       0.019999338,
167       -0.05521377,
168       -0.07650746,
169       -0.017710293,
170       -0.033986397,
171       -0.047768556,
172       0.13857274,
173       0.099290825,
174       0.11736938,
175       0.017834296,
176       -0.07140237,
177       -0.052047748,
178       -0.06398965,
179       -0.037033975,
180       -0.061061256,
181       -0.03330076,
182       -0.024472248,
183       -0.059656,
184       0.05359946,
185       -0.043915518,
186       -0.086325996,
187       0.14189173,
188       0.021086395,
189       0.02945159,
190       0.1029604,
191       0.018490415,
192       -0.028736332,
193       -0.025272416,
194       -0.06082937,
195       -0.031339463,
196       -0.0007249595,
197       0.025595888,
198       0.007144545,
199       -0.16938712,
200       -0.1160664,
201       -0.0654145
202     ],
203     "base_voice_id": "a0e99841-438c-4a64-b679-ae501e7d6091"
204   }
205 ]

API Status and Version

Up Next

Built with

1	curl https://api.cartesia.ai/voices \
2	-H "Cartesia-Version: 2024-06-10" \
3	-H "X-API-Key: <apiKey>"

1	[
2	{
3	"id": "a0e99841-438c-4a64-b679-ae501e7d6091",
4	"user_id": "user_id",
5	"is_public": true,
6	"name": "Barbershop Man",
7	"description": "A deep, rich, male voice with an Indian accent.",
8	"created_at": "created_at",
9	"embedding": [
10	-0.033633083,
11	0.072083704,
12	-0.01807767,
13	-0.083488315,
14	-0.04407617,
15	0.0022592682,
16	0.070505895,
17	0.023946615,
18	-0.04788024,
19	-0.06388413,
20	-0.0716355,
21	-0.0022612812,
22	-0.0053448505,
23	-0.07848381,
24	0.0348162,
25	-0.053745482,
26	-0.092399485,
27	-0.02950225,
28	0.028591828,
29	-0.10556894,
30	0.023313355,
31	0.06224387,
32	0.0362463,
33	0.029258432,
34	0.10769641,
35	0.043595582,
36	-0.058543224,
37	-0.080402784,
38	-0.0953816,
39	-0.008988032,
40	-0.0028981369,
41	-0.004752721,
42	-0.20742874,
43	0.058907595,
44	0.08813939,
45	-0.06192675,
46	0.099082634,
47	-0.09661578,
48	-0.0077761724,
49	-0.013982456,
50	-0.025798267,
51	0.04467142,
52	0.026222011,
53	0.023023574,
54	0.011227064,
55	-0.17462021,
56	-0.09880612,
57	-0.1521035,
58	-0.060464993,
59	-0.04735665,
60	-0.09725187,
61	-0.006127679,
62	0.15818526,
63	-0.039493002,
64	-0.067719474,
65	0.0066190436,
66	-0.10636633,
67	0.17073768,
68	-0.051717706,
69	0.03186961,
70	-0.020547207,
71	-0.02244247,
72	0.013196935,
73	-0.06431055,
74	-0.115360335,
75	0.016918058,
76	-0.033195216,
77	0.11255181,
78	0.020366343,
79	-0.041032124,
80	0.08780918,
81	-0.040567942,
82	0.057276532,
83	0.05848221,
84	-0.077479474,
85	-0.073524915,
86	-0.01913317,
87	-0.029291833,
88	0.11210393,
89	-0.09859328,
90	0.2152541,
91	-0.022976823,
92	0.028627992,
93	-0.039598297,
94	0.041829932,
95	-0.05593181,
96	-0.06444655,
97	-0.018057477,
98	-0.008098263,
99	0.05994528,
100	0.10430693,
101	-0.13121894,
102	-0.06512868,
103	-0.026126215,
104	0.046727825,
105	-0.17180993,
106	-0.10577226,
107	-0.08610466,
108	0.008862588,
109	0.09547498,
110	-0.010965332,
111	-0.061217085,
112	-0.038954042,
113	0.019930292,
114	-0.017192135,
115	0.007296275,
116	0.03273872,
117	0.04389937,
118	-0.056483064,
119	0.003420891,
120	-0.10319067,
121	-0.015706042,
122	0.1308774,
123	-0.0018035866,
124	-0.03582506,
125	0.077131025,
126	0.013398928,
127	0.003188886,
128	0.12039741,
129	-0.033974767,
130	0.06899378,
131	-0.059775922,
132	-0.026934423,
133	0.028482193,
134	0.100996524,
135	0.004498743,
136	-0.02291186,
137	0.078752205,
138	-0.0063796206,
139	0.04206536,
140	0.05721349,
141	0.06290694,
142	0.06130212,
143	0.096969016,
144	-0.057664312,
145	-0.16727506,
146	-0.035220966,
147	0.090760484,
148	0.010039947,
149	0.06513242,
150	0.011055657,
151	-0.004258431,
152	-0.08316792,
153	-0.15650468,
154	-0.076931365,
155	0.11385587,
156	-0.038372636,
157	0.015648656,
158	-0.12029895,
159	-0.06604956,
160	0.009441591,
161	-0.11912808,
162	0.013378132,
163	0.029525978,
164	-0.0056742397,
165	-0.0075976513,
166	0.019999338,
167	-0.05521377,
168	-0.07650746,
169	-0.017710293,
170	-0.033986397,
171	-0.047768556,
172	0.13857274,
173	0.099290825,
174	0.11736938,
175	0.017834296,
176	-0.07140237,
177	-0.052047748,
178	-0.06398965,
179	-0.037033975,
180	-0.061061256,
181	-0.03330076,
182	-0.024472248,
183	-0.059656,
184	0.05359946,
185	-0.043915518,
186	-0.086325996,
187	0.14189173,
188	0.021086395,
189	0.02945159,
190	0.1029604,
191	0.018490415,
192	-0.028736332,
193	-0.025272416,
194	-0.06082937,
195	-0.031339463,
196	-0.0007249595,
197	0.025595888,
198	0.007144545,
199	-0.16938712,
200	-0.1160664,
201	-0.0654145
202	],
203	"base_voice_id": "a0e99841-438c-4a64-b679-ae501e7d6091"
204	}
205	]