Localize Voice — Cartesia

Takes a voice embedding, and target language, and localizes the voice to the specific language. For certain languages, this improves the quality of the accent.

Pricing: This endpoint costs 225 characters of utilization per call.

Headers

Auth

X-API-KeystringRequired

Cartesia-VersionstringRequired

The version of the Cartesia API to use.

Request

This endpoint expects an object.

embeddinglist of doublesRequired

languageenumRequired

Target language, which the output embedding will be localized to. Options: en (English), de (German), es (Spanish), fr (French), ja (Japanese), pt (Portuguese), zh (Chinese).

original_speaker_gender"male" or "female"Required

Allowed values: malefemale

Speaker gender of the original speaker, used to accurately localize voice.

dialectenumOptional

Allowed values: auinsoukus

Target accent/dialect, which the output embedding will be localized to. Currently only supported for language en. Options: au (Australian), in (Indian), so (Southern [American]), uk (British), us (American).

Response

This endpoint returns an object.

embeddinglist of doubles

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

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

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