Get voice

GET

/v1/voices/:voice_id

GET

/v1/voices/:voice_id

1 from elevenlabs import ElevenLabs
2 
3 client = ElevenLabs(
4     api_key="YOUR_API_KEY",
5 )
6 client.voices.get(
7     voice_id="JBFqnCBsd6RMkjVDRZzb",
8 )

Try it

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

Returns metadata about a specific voice.

Path parameters

voice_idstringRequired

ID of the voice to be used. You can use the Get voices endpoint list all the available voices.

Query parameters

with_settingsbooleanOptionalDefaults to trueDeprecated

This parameter is now deprecated. It is ignored and will be removed in a future version.

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.

Get voice

Path parameters

Headers

Query parameters

Response

Errors