Ir para a navegação
Voices API

Get Voice

Retrieve a single voice by the same id values GET /v2/voices exposes — a built-in ElevenLabs voice id or the UUID of a voice cloned by your organization. A missing or foreign-organization id returns a 404 with errorCode voice_not_found.

Autenticação

x-api-keystring
Autenticação de chave de API via cabeçalho

Parâmetros de caminho

idstringObrigatório

The voice id — a built-in provider voice id or a cloned voice UUID.

Parâmetros de consulta

providerenumOpcional

Provider to resolve the voice against. Currently elevenlabs.

Valores permitidos:

Resposta

Voice retrieved successfully
providerenum
The voice provider.
Valores permitidos:
idstringOpcional
The voice id to pass as voiceId in TTS and generation text inputs.
internalVoiceIdstringOpcional
The internal id of a cloned voice, when applicable.
voiceIdstringOpcional

The provider (ElevenLabs) voice id.

namestringOpcional
The display name of the voice.
previewUrlstringOpcional
A URL to a short preview sample of the voice, when available.
restrictionenumOpcional

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.

Valores permitidos:

Erros

401
Unauthorized Error
404
Not Found Error
500
Internal Server Error