ElevenLabs icon

ElevenLabs

WIP
Join our community

Actions13

Overview

The "List Voices" operation of the ElevenLabs node retrieves a list of available voices from the ElevenLabs API. This can include both user-created voices and optionally premade voices provided by the service. It is useful for scenarios where you want to present or select from a catalog of voices for text-to-speech synthesis or voice customization workflows.

Practical examples:

  • Fetching all custom voices created by a user to allow selection in a subsequent text-to-speech step.
  • Including premade voices to offer a broader range of voice options in an application.
  • Automating voice management by listing voices and performing actions like updates or deletions based on the retrieved list.

Properties

Name Meaning
Simplify Output Whether to return a simplified version of the response (true/false).
Include Premade Whether to include premade voices in the response (true/false).

Additionally, there is a notice property displayed as informational text about the node being in beta and under active development, with links for more information and support.

Output

The output JSON contains the list of voices retrieved from the ElevenLabs API. If "Simplify Output" is enabled, the response is transformed into a simpler structure focusing on key voice attributes for easier consumption. Otherwise, the full API response is returned.

The output typically includes details such as:

  • Voice identifiers
  • Voice names
  • Voice characteristics or metadata
  • Whether the voice is premade or user-created (if included)

No binary data output is indicated for this operation.

Dependencies

  • Requires an API key credential for authenticating requests to the ElevenLabs API.
  • The node makes HTTP POST requests to https://api.elevenlabs.io/v1.
  • No additional external dependencies are indicated beyond the ElevenLabs API access.

Troubleshooting

  • Common issues:

    • Invalid or missing API key will cause authentication errors.
    • Network connectivity problems may prevent successful API calls.
    • Enabling "Include Premade" without proper API support might result in empty or partial results.

  • Error messages:

    • Authentication failures typically indicate invalid credentials; verify and update the API key.
    • API rate limits or quota exceeded errors require checking usage limits on the ElevenLabs account.
    • Unexpected response formats may occur if the API changes; ensure the node is updated to the latest version.

Links and References

Discussion