Actions7
- Voice Actions
- Speech Actions
Overview
The node interacts with the ElevenLabs API, specifically to retrieve information about a voice resource when using the "Get" operation. This allows users to fetch detailed data about a specific voice available in the ElevenLabs system. It is useful in scenarios where you want to obtain metadata or configuration details of a particular voice before using it for text-to-speech synthesis or other voice-related tasks.
For example, you might use this node to:
- Retrieve the properties of a selected voice to display them in your workflow.
- Verify voice availability or settings before generating speech.
- Integrate voice selection dynamically based on retrieved voice details.
Properties
| Name | Meaning |
|---|---|
| Voice | The voice to retrieve. Can be selected from a searchable list of voices or specified by ID. |
| Simplify | Whether to simplify the response. If true, the output will contain a simplified version of the voice data. |
Details on "Voice" property modes:
- From list: Choose a voice from a searchable list provided by the API.
- ID: Provide the unique identifier of the voice directly.
Output
The node outputs JSON data representing the voice details fetched from the ElevenLabs API. The structure includes all metadata and configuration related to the selected voice.
If the "Simplify" option is enabled, the output JSON will be a simplified version containing only essential voice information, making it easier to consume in subsequent workflow steps.
No binary data output is produced by this node.
Dependencies
- Requires an API key credential for ElevenLabs API authentication.
- 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 communication.
Troubleshooting
Common issues:
- Invalid or missing API key: Ensure the API key credential is correctly set up and has the required permissions.
- Voice not found: When specifying a voice by ID, verify that the ID is correct and the voice exists.
- Network or API errors: Check network connectivity and ElevenLabs service status.
Error messages:
- Authentication errors typically indicate problems with the API key.
- Not found errors suggest the voice ID does not exist.
- Rate limit errors may occur if too many requests are sent in a short time; consider adding delays or retries.
Links and References
- ElevenLabs API Documentation (for detailed API endpoints and voice resource info)
- n8n documentation on Using API Credentials