ElevenLabs icon

ElevenLabs

Generate natural-sounding speech using ElevenLabs AI
Join our community

Actions13

Overview

The ElevenLabs node enables interaction with the ElevenLabs API to generate natural-sounding speech and manage custom voices. Specifically, the Clone Voice operation under the Voice resource allows users to create a new voice by cloning an existing one, optionally customizing its name, description, and labels.

This operation is useful when you want to replicate a voice profile for further customization or reuse without starting from scratch. For example, you might clone a voice that fits your brand's tone and then tweak its metadata or use it in different text-to-speech scenarios.

Properties

Name Meaning
API Key Notice A notice informing the user that an API key from ElevenLabs is required. It includes a link to obtain the key.
Name The name of the cloned voice. This identifies the new voice created by cloning.
Additional Fields Optional extra information for the cloned voice:
- Description A textual description of the voice (default: "Generate with n8n").
- Labels (JSON) JSON object containing up to 5 labels describing the voice, e.g., language, descriptive tags.

Output

The node outputs JSON data representing the newly cloned voice. This typically includes details such as the voice's unique identifier, name, description, labels, and other metadata returned by the ElevenLabs API.

If the node supports binary data output (not explicitly shown here), it would represent audio files generated or associated with the voice, but this operation primarily deals with voice metadata management.

Dependencies

  • Requires an API key credential from ElevenLabs to authenticate requests.
  • The node communicates with the ElevenLabs API endpoint at https://api.elevenlabs.io/v1.
  • No additional external dependencies are indicated.

Troubleshooting

  • Missing or invalid API key: The node requires a valid API key from ElevenLabs. Ensure the key is correctly configured in the node credentials.
  • Invalid JSON in Labels field: The "Labels (JSON)" property must be valid JSON. Malformed JSON will cause errors.
  • Exceeding label limits: The API restricts labels to a maximum of 5. Providing more may result in rejection.
  • Network or API errors: Check network connectivity and ElevenLabs service status if requests fail.
  • Name conflicts: Cloning a voice with a name that already exists might cause issues depending on API constraints.

Links and References

Discussion