Zur Navigation springen
Voices API

List Voices

List the voices available to your organization — built-in ElevenLabs voices plus any you have cloned. Use a voice’s id as voiceId in POST /v2/tts and in generation text inputs. A voice that carries a restriction cannot currently synthesize speech — check restriction and choose another voice. Voice availability can change over time, so re-check it rather than assuming a voice stays usable.

Authentifizierung

x-api-keystring
API-Key-Authentifizierung via Header

Abfrageparameter

providerenumOptional

Filter voices by provider. Currently elevenlabs.

Erlaubte Werte:

Antwort

Voices retrieved successfully
providerenum
The voice provider.
Erlaubte Werte:
idstringOptional
The voice id to pass as voiceId in TTS and generation text inputs.
internalVoiceIdstringOptional
The internal id of a cloned voice, when applicable.
voiceIdstringOptional

The provider (ElevenLabs) voice id.

namestringOptional
The display name of the voice.
previewUrlstringOptional
A URL to a short preview sample of the voice, when available.
restrictionenumOptional

Present when the voice cannot currently be used for synthesis (ElevenLabs). verification_required means the voice needs verification in ElevenLabs — complete it there if the voice is from your own connected ElevenLabs account, otherwise choose another voice. blocked means ElevenLabs has blocked the voice — choose another voice. Null or absent means the voice is unrestricted.

Erlaubte Werte:

Fehler

401
Unauthorized Error
500
Internal Server Error