list_voices
Find and filter voices from your ElevenLabs account by gender, accent, age, and use case. Get the voice_id for audio generation and preview samples before choosing.
Instructions
Find a voice to speak with, and get the voice_id that audio_generate requires. Returns the voices saved in the active ElevenLabs account — the user's own on their key, or the shared SuperCMO set on a managed key — each with its gender, accent, age, use-case and a preview_url you can hand the user so they hear it before committing. Filter by what the brief actually demands (a stated gender or accent is not negotiable) and keep limit small: offer a few candidates with their previews rather than a long list. A voice missing the attribute you filtered on is kept rather than dropped, because a voice the user cloned themselves often carries no labels at all. If the account holds no voices the result says so — a newly created ElevenLabs account starts empty, and voices must be added in the ElevenLabs dashboard before anything can be spoken.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| age | No | Filter by apparent age of the voice. | |
| limit | No | How many voices to return. Keep it small — a handful of good candidates beats a catalogue. | |
| accent | No | Filter by accent as the provider labels it (e.g. 'american', 'british', 'indian', 'australian'). Free text, since the set grows. | |
| gender | No | Filter by voice gender. Apply whenever the user stated one. | |
| search | No | Free-text match over name, description and labels (e.g. 'warm', 'storyteller'). Passed to the provider. | |
| language | No | Filter by primary language as a short code (e.g. 'en', 'hi', 'es'). | |
| use_case | No | Filter by what the voice is built for (e.g. 'advertisement', 'conversational', 'narrative_story', 'social_media', 'informative_educational'). |