Voices
Get Voice
Returns metadata about a specific voice.
GET
/
v1
/
voices
/
{voice_id}
Header
Path
Query
curl --request GET \
--url https://api.elevenlabs.io/v1/voices/{voice_id}
{
"available_for_tiers": [
"<string>"
],
"category": "<string>",
"description": "<string>",
"fine_tuning": {
"fine_tuning_requested": true,
"finetuning_state": "not_started",
"is_allowed_to_fine_tune": true,
"language": "<string>",
"manual_verification": {
"extra_text": "<string>",
"files": [],
"request_time_unix": 123
},
"manual_verification_requested": true,
"slice_ids": [],
"verification_attempts": [],
"verification_attempts_count": 123,
"verification_failures": []
},
"high_quality_base_model_ids": [
"<string>"
],
"labels": {},
"name": "<string>",
"preview_url": "<string>",
"samples": [
{
"file_name": "<string>",
"hash": "<string>",
"mime_type": "<string>",
"sample_id": "<string>",
"size_bytes": 123
}
],
"settings": {
"similarity_boost": 123,
"stability": 123,
"style": 123,
"use_speaker_boost": true
},
"sharing": {
"cloned_by_count": 123,
"description": "<string>",
"enabled_in_library": true,
"history_item_sample_id": "<string>",
"labels": {},
"liked_by_count": 123,
"name": "<string>",
"original_voice_id": "<string>",
"public_owner_id": "<string>",
"review_message": "<string>",
"review_status": "not_requested",
"status": "enabled",
"whitelisted_emails": []
},
"voice_id": "<string>"
}
Headers
xi-api-key
string
Your API key. This is required by most endpoints to access our API programatically. You can view your xi-api-key using the 'Profile' tab on the website.
Path Parameters
voice_id
string
requiredVoice ID to be used, you can use https://api.elevenlabs.io/v1/voices to list all the available voices.
Query Parameters
with_settings
boolean
default: falseIf set will return settings information corresponding to the voice, requires authorization.
Response
200 - application/json
available_for_tiers
string[]
requiredcategory
string
requireddescription
string
requiredfine_tuning
object
requiredhigh_quality_base_model_ids
string[]
requiredlabels
object
requiredname
string
requiredpreview_url
string
requiredsamples
object[]
requiredsettings
object
requiredsharing
object
requiredvoice_id
string
requiredcurl --request GET \
--url https://api.elevenlabs.io/v1/voices/{voice_id}
{
"available_for_tiers": [
"<string>"
],
"category": "<string>",
"description": "<string>",
"fine_tuning": {
"fine_tuning_requested": true,
"finetuning_state": "not_started",
"is_allowed_to_fine_tune": true,
"language": "<string>",
"manual_verification": {
"extra_text": "<string>",
"files": [],
"request_time_unix": 123
},
"manual_verification_requested": true,
"slice_ids": [],
"verification_attempts": [],
"verification_attempts_count": 123,
"verification_failures": []
},
"high_quality_base_model_ids": [
"<string>"
],
"labels": {},
"name": "<string>",
"preview_url": "<string>",
"samples": [
{
"file_name": "<string>",
"hash": "<string>",
"mime_type": "<string>",
"sample_id": "<string>",
"size_bytes": 123
}
],
"settings": {
"similarity_boost": 123,
"stability": 123,
"style": 123,
"use_speaker_boost": true
},
"sharing": {
"cloned_by_count": 123,
"description": "<string>",
"enabled_in_library": true,
"history_item_sample_id": "<string>",
"labels": {},
"liked_by_count": 123,
"name": "<string>",
"original_voice_id": "<string>",
"public_owner_id": "<string>",
"review_message": "<string>",
"review_status": "not_requested",
"status": "enabled",
"whitelisted_emails": []
},
"voice_id": "<string>"
}