ElevenLabs icon

ElevenLabs

Generate natural-sounding speech using ElevenLabs AI
Join our community

Actions13

Overview

The ElevenLabs node integrates with the ElevenLabs API to generate natural-sounding speech and manage voice-related resources. Specifically, the Voice - List Voices operation retrieves a list of available voices from the ElevenLabs service. This can include user-created custom voices as well as optionally premade voices provided by ElevenLabs.

This node is useful in scenarios where you want to:

  • Display or select from a list of available voices for text-to-speech generation.
  • Manage or audit voices accessible under your ElevenLabs account.
  • Build dynamic workflows that adapt based on available voice options.

For example, a user could use this node to fetch all voices and then feed the selected voice ID into a speech synthesis operation to generate audio content.

Properties

Name Meaning
API Key Notice A notice informing users they need an API key from ElevenLabs to use the node.
Simplify Output Whether to return a simplified version of the response (boolean).
Include Premade Whether to include premade voices in the response (boolean).
  • Simplify Output: When enabled, the node returns a streamlined list of voices with essential details only.
  • Include Premade: When enabled, the response includes both user-created and premade voices; otherwise, only user-created voices are returned.

Output

The node outputs JSON data containing the list of voices retrieved from the ElevenLabs API. The structure typically includes:

  • An array of voice objects, each representing a voice with properties such as:
    • Voice ID
    • Name
    • Description or metadata
    • Possibly other attributes like language or voice characteristics

If "Simplify Output" is enabled, the output will be a reduced form focusing on key voice details for easier consumption.

The node does not output binary data for this operation.

Dependencies

  • Requires an API key credential from ElevenLabs to authenticate requests.
  • The node makes HTTP POST requests to the ElevenLabs API endpoint at https://api.elevenlabs.io/v1.
  • No additional external dependencies beyond the ElevenLabs API and proper credential configuration in n8n.

Troubleshooting

  • Missing or invalid API key: The node requires a valid API key from ElevenLabs. If authentication fails, ensure the API key is correctly set up in n8n credentials.
  • Network issues or API downtime: Connectivity problems or ElevenLabs service interruptions may cause request failures.
  • Unexpected response format: If the API changes its response schema, the node’s output might not match expectations, especially when "Simplify Output" is enabled.
  • Permission errors: Ensure the API key has sufficient permissions to list voices.

Common error messages will relate to authentication failure, rate limiting, or invalid parameters. Checking the API key validity and network connectivity usually resolves these.

Links and References

Discussion