Save a voice preview | ElevenLabs Documentation

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

1 { 2 "voice_id": "21m00Tcm4TlvDq8ikWAM", 3 "name": "Rachel", 4 "category": "professional", 5 "fine_tuning": { 6 "is_allowed_to_fine_tune": true, 7 "state": { 8 "eleven_multilingual_v2": "fine_tuned" 9 }, 10 "verification_failures": [], 11 "verification_attempts_count": 2, 12 "manual_verification_requested": false 13 }, 14 "labels": { 15 "accent": "American", 16 "age": "middle-aged", 17 "description": "expressive", 18 "gender": "female", 19 "use_case": "social media" 20 }, 21 "description": "A warm, expressive voice with a touch of humor.", 22 "preview_url": "https://storage.googleapis.com/eleven-public-prod/premade/voices/9BWtsMINqrJLrRacOk9x/405766b8-1f4e-4d3c-aba1-6f25333823ec.mp3", 23 "available_for_tiers": [ 24 "creator", 25 "enterprise" 26 ], 27 "settings": { 28 "stability": 1, 29 "use_speaker_boost": true, 30 "similarity_boost": 1, 31 "style": 0, 32 "speed": 1 33 }, 34 "sharing": { 35 "status": "enabled", 36 "history_item_sample_id": "DCwhRBWXzGAHq8TQ4Fs18", 37 "date_unix": 1714204800, 38 "whitelisted_emails": [ 39 "example@example.com" 40 ], 41 "public_owner_id": "DCwhRBWXzGAHq8TQ4Fs18", 42 "original_voice_id": "DCwhRBWXzGAHq8TQ4Fs18", 43 "financial_rewards_enabled": true, 44 "free_users_allowed": true, 45 "live_moderation_enabled": true, 46 "rate": 0.05, 47 "notice_period": 30, 48 "disable_at_unix": 1714204800, 49 "voice_mixing_allowed": false, 50 "featured": true, 51 "category": "professional", 52 "reader_app_enabled": true, 53 "liked_by_count": 100, 54 "cloned_by_count": 50, 55 "name": "Rachel", 56 "description": "A female voice with a soft and friendly tone.", 57 "labels": { 58 "accent": "American", 59 "gender": "female" 60 }, 61 "review_status": "allowed", 62 "enabled_in_library": true, 63 "moderation_check": { 64 "date_checked_unix": 1714204800, 65 "name_value": "Rachel", 66 "name_check": true, 67 "description_value": "A female voice with a soft and friendly tone.", 68 "description_check": true, 69 "sample_ids": [ 70 "sample1", 71 "sample2" 72 ], 73 "sample_checks": [ 74 0.95, 75 0.98 76 ], 77 "captcha_ids": [ 78 "captcha1", 79 "captcha2" 80 ], 81 "captcha_checks": [ 82 0.95, 83 0.98 84 ] 85 }, 86 "reader_restricted_on": [ 87 { 88 "resource_type": "read", 89 "resource_id": "FCwhRBWXzGAHq8TQ4Fs18" 90 } 91 ] 92 }, 93 "high_quality_base_model_ids": [ 94 "eleven_v2_flash", 95 "eleven_flash_v2", 96 "eleven_turbo_v2_5", 97 "eleven_multilingual_v2", 98 "eleven_v2_5_flash", 99 "eleven_flash_v2_5", 100 "eleven_turbo_v2" 101 ], 102 "verified_languages": [ 103 { 104 "language": "en", 105 "model_id": "eleven_turbo_v2_5", 106 "accent": "American" 107 } 108 ], 109 "voice_verification": { 110 "requires_verification": false, 111 "is_verified": true, 112 "verification_failures": [], 113 "verification_attempts_count": 0, 114 "language": "en", 115 "verification_attempts": [ 116 { 117 "text": "Hello, how are you?", 118 "date_unix": 1714204800, 119 "accepted": true, 120 "similarity": 0.95, 121 "levenshtein_distance": 2, 122 "recording": { 123 "recording_id": "CwhRBWXzGAHq8TQ4Fs17", 124 "mime_type": "audio/mpeg", 125 "size_bytes": 1000000, 126 "upload_date_unix": 1714204800, 127 "transcription": "Hello, how are you?" 128 } 129 } 130 ] 131 }, 132 "is_owner": false, 133 "is_legacy": false, 134 "is_mixed": false 135 }

Add a generated voice to the voice library.

Headers

xi-api-keystringRequired

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 or null

The name of the voice.

sampleslist of objects or null

List of samples associated with the voice.

categoryenum or null

The category of the voice.

fine_tuningobject or null

Fine-tuning information for the voice.

labelsmap from strings to strings or null

Labels associated with the voice.

descriptionstring or null

The description of the voice.

preview_urlstring or null

The preview URL of the voice.

available_for_tierslist of strings or null

The tiers the voice is available for.

settingsobject or null

The settings of the voice.

high_quality_base_model_idslist of strings or null

The base model IDs for high-quality voices.

verified_languageslist of objects or null

The verified languages of the voice.

safety_controlenum or null

The safety controls of the voice.

voice_verificationobject or null

The voice verification of the voice.

permission_on_resourcestring or null

The permission on the resource of the voice.

is_ownerboolean or null

Whether the voice is owned by the user.

is_legacyboolean or nullDefaults to false

Whether the voice is legacy.

is_mixedboolean or nullDefaults to false

Whether the voice is mixed.

created_at_unixinteger or null

The creation time of the voice in Unix time.

Headers

Request

Response

Errors