For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Connect
BlogHelp CenterAPI PricingSign up
OverviewElevenCreativeElevenAgentsElevenAPIAPI referenceChangelog
OverviewElevenCreativeElevenAgentsElevenAPIAPI referenceChangelog
  • API reference
    • Introduction
    • Authentication
    • Streaming
  • ElevenAgents
  • ElevenAPI
      • POSTDesign a voice
      • POSTCreate a voice
      • POSTRemix a voice
      • STREAMStream voice preview
  • ElevenCreative
  • Core Resources
  • Workspace
  • Legacy
LogoLogo
Login
Login
Connect
BlogHelp CenterAPI PricingSign up
ElevenAPIVoice Design

Create a voice

POST
/v1/text-to-voice
POST
/v1/text-to-voice
$curl -X POST https://api.elevenlabs.io/v1/text-to-voice \
>     -H "Content-Type: application/json" \
>     -d '{
>  "voice_name": "Sassy squeaky mouse",
>  "voice_description": "A sassy squeaky mouse",
>  "generated_voice_id": "37HceQefKmEi3bGovXjL"
>}'
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_multilingual_v2",
106      "accent": "american",
107      "locale": "en-US",
108      "preview_url": "https://storage.googleapis.com/eleven-public-prod/premade/voices/9BWtsMINqrJLrRacOk9x/405766b8-1f4e-4d3c-aba1-6f25333823ec.mp3"
109    }
110  ],
111  "voice_verification": {
112    "requires_verification": false,
113    "is_verified": true,
114    "verification_failures": [],
115    "verification_attempts_count": 0,
116    "language": "en",
117    "verification_attempts": [
118      {
119        "text": "Hello, how are you?",
120        "date_unix": 1714204800,
121        "accepted": true,
122        "similarity": 0.95,
123        "levenshtein_distance": 2,
124        "recording": {
125          "recording_id": "CwhRBWXzGAHq8TQ4Fs17",
126          "mime_type": "audio/mpeg",
127          "size_bytes": 1000000,
128          "upload_date_unix": 1714204800,
129          "transcription": "Hello, how are you?"
130        }
131      }
132    ]
133  },
134  "is_owner": false,
135  "is_legacy": false,
136  "is_mixed": false
137}

Create a voice from previously generated voice preview. This endpoint should be called after you fetched a generated_voice_id using POST /v1/text-to-voice/design or POST /v1/text-to-voice/:voice_id/remix.

Was this page helpful?
Previous

Remix a voice

Next
Built with

Headers

xi-api-keystringOptional

Request

This endpoint expects an object.
voice_namestringRequired
Name to use for the created voice.
voice_descriptionstringRequired20-1000 characters
Description to use for the created voice.
generated_voice_idstringRequired

The generated_voice_id to create; obtain it from POST /v1/text-to-voice/design, POST /v1/text-to-voice/:voice_id/remix, or the response headers when generating previews.

labelsmap from strings to strings or nullOptional
Optional, metadata to add to the created voice. Defaults to None.
played_not_selected_voice_idslist of strings or nullOptional
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.
sampleslist of objects or null
List of samples associated with the voice.
categoryenum
The category of the voice.
fine_tuningobject or null

Fine-tuning information for the voice.

labelsmap from strings to strings
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
The tiers the voice is available for.
settingsobject or null
The settings of the voice.
sharingobject or null
The sharing information of the voice.
high_quality_base_model_idslist of strings

The base model IDs for high-quality voices.

verified_languageslist of objects or null
The verified languages of the voice.
collection_idslist of strings or null
The IDs of collections this voice belongs to.
safety_controlenum or null
The safety controls of the voice.
Allowed values:
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_legacybooleanDefaults to false
Whether the voice is legacy.
is_mixedbooleanDefaults to false
Whether the voice is mixed.
favorited_at_unixinteger or null
Timestamp when the voice was marked as favorite in Unix time.
created_at_unixinteger or null
The creation time of the voice in Unix time.
is_bookmarkedboolean or null

Whether the voice is bookmarked by the current user. Only relevant for community (library-copied) voices.

recording_qualityenum or null
The recording quality of the voice as determined by the review pipeline.
Allowed values:
labelling_statusenum or null
The review pipeline status of the voice.
Allowed values:
recording_quality_reasonstring or null
The reason for the recording quality assessment, as determined by the review pipeline.

Errors

422
Unprocessable Entity Error