Save a voice preview — ElevenLabs Documentation

Add a generated voice to the voice library.

Request

This endpoint expects an object.

voice_namestringRequired

Name to use for the created voice.

voice_descriptionstringRequired>=20 characters<=1000 characters

Description to use for the created voice.

generated_voice_idstringRequired

The generated_voice_id to create, call POST /v1/text-to-voice/create-previews and fetch the generated_voice_id from the response header if don’t have one yet.

labelsmap from strings to stringsOptional

Optional, metadata to add to the created voice. Defaults to None.

played_not_selected_voice_idslist of stringsOptional

List of voice ids that the user has played but not selected. Used for RLHF.

Response

Successful Response

voice_idstring

The ID of the voice.

namestring

The name of the voice.

categoryenum

The category of the voice.

labelsmap from strings to strings

Labels associated with the voice.

available_for_tierslist of strings

The tiers the voice is available for.

high_quality_base_model_idslist of strings

The base model IDs for high-quality voices.

sampleslist of objectsOptional

List of samples associated with the voice.

fine_tuningobjectOptional

Fine-tuning information for the voice.

descriptionstringOptional

The description of the voice.

preview_urlstringOptional

The preview URL of the voice.

settingsobjectOptional

The settings of the voice.

verified_languageslist of objectsOptional

The verified languages of the voice.

safety_controlenumOptional

The safety controls of the voice.

voice_verificationobjectOptional

The voice verification of the voice.

permission_on_resourcestringOptional

The permission on the resource of the voice.

is_ownerbooleanOptional

Whether the voice is owned by the user.

is_legacybooleanOptionalDefaults to false

Whether the voice is legacy.

is_mixedbooleanOptionalDefaults to false

Whether the voice is mixed.

created_at_unixintegerOptional

The creation time of the voice in Unix time.

Errors

1 curl -X POST https://api.elevenlabs.io/v1/text-to-voice/create-voice-from-preview \ 2 -H "xi-api-key: <apiKey>" \ 3 -H "Content-Type: application/json" \ 4 -d '{ 5 "voice_name": "Sassy squeaky mouse", 6 "voice_description": "A sassy squeaky mouse", 7 "generated_voice_id": "37HceQefKmEi3bGovXjL" 8 }'

1 { 2 "voice_id": "21m00Tcm4TlvDq8ikWAM", 3 "name": "Rachel", 4 "category": "professional", 5 "labels": { 6 "accent": "American", 7 "description": "expressive", 8 "age": "middle-aged", 9 "gender": "female", 10 "use_case": "social media" 11 }, 12 "available_for_tiers": [ 13 "creator", 14 "enterprise" 15 ], 16 "high_quality_base_model_ids": [ 17 "eleven_v2_flash", 18 "eleven_flash_v2", 19 "eleven_turbo_v2_5", 20 "eleven_multilingual_v2", 21 "eleven_v2_5_flash", 22 "eleven_flash_v2_5", 23 "eleven_turbo_v2" 24 ], 25 "samples": [ 26 { 27 "sample_id": "DCwhRBWXzGAHq8TQ4Fs18", 28 "file_name": "sample.mp3", 29 "mime_type": "audio/mpeg", 30 "size_bytes": 1000000, 31 "hash": "1234567890" 32 } 33 ], 34 "fine_tuning": { 35 "is_allowed_to_fine_tune": true, 36 "state": { 37 "eleven_multilingual_v2": "fine_tuned" 38 }, 39 "verification_failures": [ 40 "verification_failures" 41 ], 42 "verification_attempts_count": 2, 43 "manual_verification_requested": false, 44 "language": "language", 45 "progress": { 46 "key": 1.1 47 }, 48 "message": { 49 "key": "value" 50 }, 51 "dataset_duration_seconds": 1.1, 52 "verification_attempts": [ 53 { 54 "text": "Hello, how are you?", 55 "date_unix": 1714204800, 56 "accepted": true, 57 "similarity": 0.95, 58 "levenshtein_distance": 2, 59 "recording": { 60 "recording_id": "CwhRBWXzGAHq8TQ4Fs17", 61 "mime_type": "audio/mpeg", 62 "size_bytes": 1000000, 63 "upload_date_unix": 1714204800, 64 "transcription": "Hello, how are you?" 65 } 66 } 67 ], 68 "slice_ids": [ 69 "slice_ids" 70 ], 71 "manual_verification": { 72 "extra_text": "Please verify the voice is that of a female.", 73 "request_time_unix": 1714204800, 74 "files": [ 75 { 76 "file_id": "CwhRBWXzGAHq8TQ4Fs18", 77 "file_name": "file.mp3", 78 "mime_type": "audio/mpeg", 79 "size_bytes": 1000000, 80 "upload_date_unix": 1714204800 81 } 82 ] 83 }, 84 "max_verification_attempts": 1, 85 "next_max_verification_attempts_reset_unix_ms": 1, 86 "finetuning_state": { 87 "key": "value" 88 } 89 }, 90 "description": "A warm, expressive voice with a touch of humor.", 91 "preview_url": "https://storage.googleapis.com/eleven-public-prod/premade/voices/9BWtsMINqrJLrRacOk9x/405766b8-1f4e-4d3c-aba1-6f25333823ec.mp3", 92 "settings": { 93 "stability": 1, 94 "similarity_boost": 1, 95 "style": 0, 96 "use_speaker_boost": true, 97 "speed": 1 98 }, 99 "sharing": { 100 "status": "enabled", 101 "date_unix": 1714204800, 102 "whitelisted_emails": [ 103 "example@example.com" 104 ], 105 "public_owner_id": "DCwhRBWXzGAHq8TQ4Fs18", 106 "original_voice_id": "DCwhRBWXzGAHq8TQ4Fs18", 107 "financial_rewards_enabled": true, 108 "free_users_allowed": true, 109 "live_moderation_enabled": true, 110 "notice_period": 30, 111 "voice_mixing_allowed": false, 112 "featured": true, 113 "category": "professional", 114 "liked_by_count": 100, 115 "cloned_by_count": 50, 116 "name": "Rachel", 117 "labels": { 118 "accent": "American", 119 "gender": "female" 120 }, 121 "review_status": "allowed", 122 "enabled_in_library": true, 123 "history_item_sample_id": "DCwhRBWXzGAHq8TQ4Fs18", 124 "rate": 0.05, 125 "disable_at_unix": 1714204800, 126 "reader_app_enabled": true, 127 "image_url": "image_url", 128 "ban_reason": "ban_reason", 129 "description": "A female voice with a soft and friendly tone.", 130 "review_message": "review_message", 131 "instagram_username": "instagram_username", 132 "twitter_username": "twitter_username", 133 "youtube_username": "youtube_username", 134 "tiktok_username": "tiktok_username", 135 "moderation_check": { 136 "date_checked_unix": 1714204800, 137 "name_value": "Rachel", 138 "name_check": true, 139 "description_value": "A female voice with a soft and friendly tone.", 140 "description_check": true, 141 "sample_ids": [ 142 "sample1", 143 "sample2" 144 ], 145 "sample_checks": [ 146 0.95, 147 0.98 148 ], 149 "captcha_ids": [ 150 "captcha1", 151 "captcha2" 152 ], 153 "captcha_checks": [ 154 0.95, 155 0.98 156 ] 157 }, 158 "reader_restricted_on": [ 159 { 160 "resource_type": "read", 161 "resource_id": "FCwhRBWXzGAHq8TQ4Fs18" 162 } 163 ] 164 }, 165 "verified_languages": [ 166 { 167 "language": "en", 168 "model_id": "eleven_turbo_v2_5", 169 "accent": "American", 170 "preview_url": "preview_url" 171 } 172 ], 173 "safety_control": "NONE", 174 "voice_verification": { 175 "requires_verification": false, 176 "is_verified": true, 177 "verification_failures": [ 178 "verification_failures" 179 ], 180 "verification_attempts_count": 0, 181 "language": "en", 182 "verification_attempts": [ 183 { 184 "text": "Hello, how are you?", 185 "date_unix": 1714204800, 186 "accepted": true, 187 "similarity": 0.95, 188 "levenshtein_distance": 2, 189 "recording": { 190 "recording_id": "CwhRBWXzGAHq8TQ4Fs17", 191 "mime_type": "audio/mpeg", 192 "size_bytes": 1000000, 193 "upload_date_unix": 1714204800, 194 "transcription": "Hello, how are you?" 195 } 196 } 197 ] 198 }, 199 "permission_on_resource": "permission_on_resource", 200 "is_owner": false, 201 "is_legacy": false, 202 "is_mixed": false, 203 "created_at_unix": 1 204 }

1	curl -X POST https://api.elevenlabs.io/v1/text-to-voice/create-voice-from-preview \
2	-H "xi-api-key: <apiKey>" \
3	-H "Content-Type: application/json" \
4	-d '{
5	"voice_name": "Sassy squeaky mouse",
6	"voice_description": "A sassy squeaky mouse",
7	"generated_voice_id": "37HceQefKmEi3bGovXjL"
8	}'

1	{
2	"voice_id": "21m00Tcm4TlvDq8ikWAM",
3	"name": "Rachel",
4	"category": "professional",
5	"labels": {
6	"accent": "American",
7	"description": "expressive",
8	"age": "middle-aged",
9	"gender": "female",
10	"use_case": "social media"
11	},
12	"available_for_tiers": [
13	"creator",
14	"enterprise"
15	],
16	"high_quality_base_model_ids": [
17	"eleven_v2_flash",
18	"eleven_flash_v2",
19	"eleven_turbo_v2_5",
20	"eleven_multilingual_v2",
21	"eleven_v2_5_flash",
22	"eleven_flash_v2_5",
23	"eleven_turbo_v2"
24	],
25	"samples": [
26	{
27	"sample_id": "DCwhRBWXzGAHq8TQ4Fs18",
28	"file_name": "sample.mp3",
29	"mime_type": "audio/mpeg",
30	"size_bytes": 1000000,
31	"hash": "1234567890"
32	}
33	],
34	"fine_tuning": {
35	"is_allowed_to_fine_tune": true,
36	"state": {
37	"eleven_multilingual_v2": "fine_tuned"
38	},
39	"verification_failures": [
40	"verification_failures"
41	],
42	"verification_attempts_count": 2,
43	"manual_verification_requested": false,
44	"language": "language",
45	"progress": {
46	"key": 1.1
47	},
48	"message": {
49	"key": "value"
50	},
51	"dataset_duration_seconds": 1.1,
52	"verification_attempts": [
53	{
54	"text": "Hello, how are you?",
55	"date_unix": 1714204800,
56	"accepted": true,
57	"similarity": 0.95,
58	"levenshtein_distance": 2,
59	"recording": {
60	"recording_id": "CwhRBWXzGAHq8TQ4Fs17",
61	"mime_type": "audio/mpeg",
62	"size_bytes": 1000000,
63	"upload_date_unix": 1714204800,
64	"transcription": "Hello, how are you?"
65	}
66	}
67	],
68	"slice_ids": [
69	"slice_ids"
70	],
71	"manual_verification": {
72	"extra_text": "Please verify the voice is that of a female.",
73	"request_time_unix": 1714204800,
74	"files": [
75	{
76	"file_id": "CwhRBWXzGAHq8TQ4Fs18",
77	"file_name": "file.mp3",
78	"mime_type": "audio/mpeg",
79	"size_bytes": 1000000,
80	"upload_date_unix": 1714204800
81	}
82	]
83	},
84	"max_verification_attempts": 1,
85	"next_max_verification_attempts_reset_unix_ms": 1,
86	"finetuning_state": {
87	"key": "value"
88	}
89	},
90	"description": "A warm, expressive voice with a touch of humor.",
91	"preview_url": "https://storage.googleapis.com/eleven-public-prod/premade/voices/9BWtsMINqrJLrRacOk9x/405766b8-1f4e-4d3c-aba1-6f25333823ec.mp3",
92	"settings": {
93	"stability": 1,
94	"similarity_boost": 1,
95	"style": 0,
96	"use_speaker_boost": true,
97	"speed": 1
98	},
99	"sharing": {
100	"status": "enabled",
101	"date_unix": 1714204800,
102	"whitelisted_emails": [
103	"example@example.com"
104	],
105	"public_owner_id": "DCwhRBWXzGAHq8TQ4Fs18",
106	"original_voice_id": "DCwhRBWXzGAHq8TQ4Fs18",
107	"financial_rewards_enabled": true,
108	"free_users_allowed": true,
109	"live_moderation_enabled": true,
110	"notice_period": 30,
111	"voice_mixing_allowed": false,
112	"featured": true,
113	"category": "professional",
114	"liked_by_count": 100,
115	"cloned_by_count": 50,
116	"name": "Rachel",
117	"labels": {
118	"accent": "American",
119	"gender": "female"
120	},
121	"review_status": "allowed",
122	"enabled_in_library": true,
123	"history_item_sample_id": "DCwhRBWXzGAHq8TQ4Fs18",
124	"rate": 0.05,
125	"disable_at_unix": 1714204800,
126	"reader_app_enabled": true,
127	"image_url": "image_url",
128	"ban_reason": "ban_reason",
129	"description": "A female voice with a soft and friendly tone.",
130	"review_message": "review_message",
131	"instagram_username": "instagram_username",
132	"twitter_username": "twitter_username",
133	"youtube_username": "youtube_username",
134	"tiktok_username": "tiktok_username",
135	"moderation_check": {
136	"date_checked_unix": 1714204800,
137	"name_value": "Rachel",
138	"name_check": true,
139	"description_value": "A female voice with a soft and friendly tone.",
140	"description_check": true,
141	"sample_ids": [
142	"sample1",
143	"sample2"
144	],
145	"sample_checks": [
146	0.95,
147	0.98
148	],
149	"captcha_ids": [
150	"captcha1",
151	"captcha2"
152	],
153	"captcha_checks": [
154	0.95,
155	0.98
156	]
157	},
158	"reader_restricted_on": [
159	{
160	"resource_type": "read",
161	"resource_id": "FCwhRBWXzGAHq8TQ4Fs18"
162	}
163	]
164	},
165	"verified_languages": [
166	{
167	"language": "en",
168	"model_id": "eleven_turbo_v2_5",
169	"accent": "American",
170	"preview_url": "preview_url"
171	}
172	],
173	"safety_control": "NONE",
174	"voice_verification": {
175	"requires_verification": false,
176	"is_verified": true,
177	"verification_failures": [
178	"verification_failures"
179	],
180	"verification_attempts_count": 0,
181	"language": "en",
182	"verification_attempts": [
183	{
184	"text": "Hello, how are you?",
185	"date_unix": 1714204800,
186	"accepted": true,
187	"similarity": 0.95,
188	"levenshtein_distance": 2,
189	"recording": {
190	"recording_id": "CwhRBWXzGAHq8TQ4Fs17",
191	"mime_type": "audio/mpeg",
192	"size_bytes": 1000000,
193	"upload_date_unix": 1714204800,
194	"transcription": "Hello, how are you?"
195	}
196	}
197	]
198	},
199	"permission_on_resource": "permission_on_resource",
200	"is_owner": false,
201	"is_legacy": false,
202	"is_mixed": false,
203	"created_at_unix": 1
204	}