Actions16
Overview
The "List Voices" operation of the ElevenLabs node retrieves a list of available voices from the ElevenLabs API. This can include both user-created and premade voices depending on the input settings. It is useful for scenarios where you want to present or select from a catalog of text-to-speech voices, such as in voice synthesis workflows, audio content generation, or voice customization applications.
Practical examples:
- Fetching all available voices to allow users to pick one for generating speech.
- Filtering the voice list to only show custom-created voices or including premade ones.
- Integrating with other nodes to dynamically select voices based on availability.
Properties
| Name | Meaning |
|---|---|
| Simplify Output | Whether to return a simplified version of the response (true/false). |
| Include Premade | Whether to include premade voices in the response (true/false). |
Additionally, there is a notice property displayed as an informational message about the node being in beta and under active development, linking to further resources.
Output
The output JSON contains the list of voices retrieved from the ElevenLabs API. If "Simplify Output" is enabled, the response is transformed into a more concise format focusing on essential voice details. Otherwise, the full API response is returned.
The output typically includes:
- Voice identifiers
- Voice names
- Metadata about each voice (e.g., whether it is premade or custom)
- Other relevant voice attributes as provided by the API
No binary data output is indicated for this operation.
Dependencies
- Requires an API key credential for ElevenLabs API authentication.
- The node makes HTTP POST requests to
https://api.elevenlabs.io/v1. - No additional external dependencies are indicated beyond the ElevenLabs API access.
Troubleshooting
Common issues:
- Invalid or missing API key will cause authentication errors.
- Network connectivity problems may prevent reaching the ElevenLabs API.
- Using the node while the API or service is down will result in request failures.
Error messages:
- Authentication errors typically indicate invalid credentials; verify and update the API key.
- Timeout or network errors suggest checking internet connection or API status.
- Unexpected response formats may occur if the API changes; ensure the node is updated.