Create A Previously Generated Voice

Deprecated

POST

/v1/voice-generation/create-voice

Create a previously generated voice. This endpoint should be called after you fetched a generated_voice_id using /v1/voice-generation/generate-voice.

Request

This endpoint expects an object.

voice_namestringRequired

Name to use for the created voice.

voice_descriptionstringRequired

Description to use for the created voice.

generated_voice_idstringRequired

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

played_not_selected_voice_idslist of stringsOptional

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

labelsmap from strings to stringsOptional

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

Response

Successful Response

voice_idstring

namestringOptional

sampleslist of objectsOptional

categoryenumOptional

fine_tuningobjectOptional

labelsmap from strings to stringsOptional

descriptionstringOptional

preview_urlstringOptional

available_for_tierslist of stringsOptional

settingsobjectOptional

high_quality_base_model_idslist of stringsOptional

safety_controlenumOptional

voice_verificationobjectOptional

permission_on_resourcestringOptional

is_ownerbooleanOptional

is_legacybooleanOptional

is_mixedbooleanOptional

created_at_unixintegerOptional

POST

1 curl -X POST https://api.elevenlabs.io/v1/voice-generation/create-voice \
2      -H "xi-api-key: <apiKey>" \
3      -H "Content-Type: application/json" \
4      -d '{
5   "voice_name": "Alex",
6   "voice_description": "Middle-aged American woman",
7   "generated_voice_id": "rbVJFu6SGRD1dbWpKnWl"
8 }'

200Successful

1 {
2   "voice_id": "9wc1LZ6HlhyLzbBY7Vvj",
3   "name": "Alex",
4   "category": "generated",
5   "fine_tuning": {
6     "is_allowed_to_fine_tune": false,
7     "verification_failures": [],
8     "verification_attempts_count": 0,
9     "manual_verification_requested": false,
10     "finetuning_state": "not_started"
11   },
12   "labels": {},
13   "available_for_tiers": [],
14   "settings": {
15     "stability": 0.5,
16     "similarity_boost": 0.75,
17     "style": 0,
18     "use_speaker_boost": true
19   },
20   "high_quality_base_model_ids": []
21 }

Changelog

Up Next

Built with

1	curl -X POST https://api.elevenlabs.io/v1/voice-generation/create-voice \
2	-H "xi-api-key: <apiKey>" \
3	-H "Content-Type: application/json" \
4	-d '{
5	"voice_name": "Alex",
6	"voice_description": "Middle-aged American woman",
7	"generated_voice_id": "rbVJFu6SGRD1dbWpKnWl"
8	}'

1	{
2	"voice_id": "9wc1LZ6HlhyLzbBY7Vvj",
3	"name": "Alex",
4	"category": "generated",
5	"fine_tuning": {
6	"is_allowed_to_fine_tune": false,
7	"verification_failures": [],
8	"verification_attempts_count": 0,
9	"manual_verification_requested": false,
10	"finetuning_state": "not_started"
11	},
12	"labels": {},
13	"available_for_tiers": [],
14	"settings": {
15	"stability": 0.5,
16	"similarity_boost": 0.75,
17	"style": 0,
18	"use_speaker_boost": true
19	},
20	"high_quality_base_model_ids": []
21	}