Actions7
- Voice Actions
- Speech Actions
Overview
The node interacts with the ElevenLabs API, specifically focusing on managing and retrieving voice data under the "Voice" resource. The "Get Many" operation allows users to fetch multiple voice entries from the ElevenLabs service. This is useful for scenarios where you want to list available voices, perhaps to select one for text-to-speech synthesis or to manage voice assets programmatically.
Practical examples include:
- Retrieving all available voices to display in a UI dropdown.
- Fetching a limited number of voices for quick previews.
- Simplifying the response to get only essential voice details for lightweight processing.
Properties
| Name | Meaning |
|---|---|
| Return All | Whether to return all available voice results or limit the number of results returned. |
| Limit | Maximum number of voice results to return when "Return All" is false. |
| Simplify | Whether to simplify the response, likely returning a reduced set of fields for each voice. |
Output
The output contains a JSON array of voice objects retrieved from the ElevenLabs API. Each object represents a voice with its associated properties as returned by the API.
If the "Simplify" option is enabled, the output will contain a simplified version of these voice objects, including only key attributes for easier consumption.
No binary data output is indicated for this operation.
Dependencies
- Requires an API key credential for authenticating with the ElevenLabs API.
- The node makes HTTP POST requests to
https://api.elevenlabs.io/v1. - Proper configuration of the API key credential within n8n is necessary for successful execution.
Troubleshooting
Common issues:
- Authentication failures due to missing or invalid API key.
- Exceeding rate limits imposed by the ElevenLabs API.
- Request timeouts or network connectivity problems.
Error messages:
- Unauthorized or 401 errors indicate issues with the API key; verify and update credentials.
- 429 Too Many Requests suggests hitting rate limits; consider adding delays or reducing request frequency.
- Invalid parameter errors may occur if "Limit" is set below 1 or other parameters are malformed; ensure input values meet expected criteria.
Links and References
- ElevenLabs API Documentation (for detailed API endpoints and voice data structure)
- n8n Documentation on Creating Custom Nodes