ElevenLabs icon

ElevenLabs

WIP

Actions13

Overview

The "List Voices" operation of the ElevenLabs node allows users to retrieve a list of available voices from the ElevenLabs API. This is useful for scenarios where you want to present users with selectable voice options for text-to-speech tasks, automate voice selection in workflows, or simply audit which voices are available (including both custom and premade voices). For example, you might use this node to populate a dropdown menu in your application with all available voices, or to programmatically select a voice based on certain criteria.

Properties

Display Name Type Meaning
Simplify Output Boolean Whether to return a simplified version of the response. If enabled, the output will be easier to consume.
Include Premade Boolean Whether to include premade voices in the response. Useful if you want to see both custom and default voices.
Notice Notice Informational message about the node's beta status and links for more information/support.

Output

  • The node outputs a json field containing the list of voices.
  • If Simplify Output is enabled, the structure will be streamlined for easier consumption (e.g., an array of objects with key properties like name, id, etc.).
  • If Simplify Output is disabled, the full raw API response is returned, which may include additional metadata.
  • If Include Premade is enabled, the output will also contain premade/default voices in addition to any custom voices.

Example Output Structure (Simplified):

[
  {
    "id": "voice_123",
    "name": "Emma",
    "description": "English female voice"
  },
  {
    "id": "voice_456",
    "name": "John",
    "description": "US male voice"
  }
]

Note: Actual fields may vary depending on the ElevenLabs API.

Dependencies

  • External Service: Requires access to the ElevenLabs API.
  • API Key: You must configure valid ElevenLabs API credentials in n8n under the credential type elevenLabsApi.
  • n8n Configuration: No special environment variables required beyond standard credential setup.

Troubleshooting

  • Missing Credentials:
    Error Message: "No credentials found for 'elevenLabsApi'."
    Resolution: Ensure you have set up and selected the correct ElevenLabs API credentials in your n8n workflow.

  • Invalid API Key:
    Error Message: "401 Unauthorized" or similar from the API.
    Resolution: Double-check your API key and permissions in the ElevenLabs dashboard.

  • Empty Output:
    Possible Cause: No voices available, or filters exclude all results.
    Resolution: Try toggling "Include Premade" to see if default voices appear.

  • Unexpected Output Structure:
    Possible Cause: "Simplify Output" setting may not match your expectations.
    Resolution: Toggle the "Simplify Output" option to adjust the response format.

Links and References

Discussion