Actions13
- Speech Actions
- Voice Actions
- History Actions
- User Actions
Overview
The "Create Voice" operation in the ElevenLabs node allows users to create a new voice in their ElevenLabs library by using a previously generated voice ID. This is useful for managing custom voices that have been generated but not yet saved permanently in the user's voice collection. For example, after generating a unique voice with the "Generate Voice" operation, you can use this operation to add it to your library for future reuse or sharing.
Common scenarios include:
- Saving a newly generated AI voice for repeated text-to-speech tasks.
- Organizing and labeling custom voices for different languages or styles.
- Cloning existing voices with modifications and saving them under new names.
Properties
| Name | Meaning |
|---|---|
| API Key Notice | Notice informing the user that an API key from ElevenLabs is required, with a link to obtain it. |
| This creates a voice from a generated_voice_id, generated with the "Generate Voice" operation, and adds it to your library | Informational notice about the purpose of this operation. |
| Generation Voice ID | The unique identifier (generated_voice_id) of the voice that was generated and will be added. (Required) |
| Name | The name to assign to the new voice in the library. Default is "n8n voice". |
| Additional Fields | Optional extra fields to provide more details about the voice: |
| - Description | A textual description of the voice. Defaults to "Generate with n8n". |
| - Labels (JSON) | JSON object containing labels describing the voice (up to 5). Example keys: language, descriptive, generated. |
Output
The node outputs JSON data representing the created voice object as returned by the ElevenLabs API. This typically includes details such as the voice's ID, name, description, labels, and other metadata confirming successful creation.
If the node supports binary data output (not indicated here), it would represent audio files or related media, but for this operation, the focus is on voice metadata.
Dependencies
- Requires an API key credential from ElevenLabs to authenticate requests.
- The node sends HTTP POST requests to the ElevenLabs API endpoint at
https://api.elevenlabs.io/v1. - Proper configuration of the API key in n8n credentials is necessary.
Troubleshooting
- Missing or invalid API key: The node will fail if the API key is not provided or incorrect. Ensure the API key is set up correctly in n8n credentials.
- Invalid
generated_voice_id: If the provided voice ID does not exist or is malformed, the API will return an error. Verify the ID matches one generated by the "Generate Voice" operation. - JSON format errors in Labels: The "Labels (JSON)" field must contain valid JSON. Invalid JSON syntax will cause errors. Use a JSON validator before input.
- API rate limits or service downtime: If the ElevenLabs API is unreachable or rate-limited, the node will throw errors. Check network connectivity and ElevenLabs service status.
Links and References
- ElevenLabs Dashboard – Obtain your API key and manage your account.
- ElevenLabs API Documentation (general reference, not linked here due to static analysis constraints).