Eleven Labs Conversational icon

Eleven Labs Conversational

Interact with ElevenLabs Conversational AI API

Actions26

Voice → List

AI-generated

Overview

The "Voice - List" operation in this node retrieves a list of available voices from the ElevenLabs Conversational AI API. This is useful when you want to browse or select from different voice options for text-to-speech or conversational agents. For example, you might use this operation to dynamically populate a dropdown of voices in an automation workflow or to filter voices based on specific criteria like category or type before assigning one to an agent.

Properties

Name Meaning
Return All Whether to return all matching voices or limit the number of results returned.
Limit Maximum number of voices to return (only used if Return All is false). Range: 1 to 100.
Filters Collection of filters to narrow down the list of voices:
  Search Search term to filter voices by name, description, labels, or category.
  Category Filter voices by category. Options: Premade, Cloned, Generated, Professional.
  Voice Type Filter voices by type. Options: Personal, Community, Default, Workspace.
  Sort Field to sort the results by. Options: Created At, Name.
  Sort Direction Sort order direction. Options: Ascending, Descending.
  Include Total Count Whether to include the total count of voices in the response (may impact performance).

Output

The output JSON contains an array of voice objects matching the specified filters and limits. Each voice object typically includes details such as voice ID, name, description, category, type, and other metadata relevant to the voice. If the "Include Total Count" option is enabled, the response also includes the total number of voices available that match the filters.

This operation does not output binary data.

Dependencies

  • Requires an API key credential for authenticating with the ElevenLabs Conversational AI API.
  • The node depends on the ElevenLabs API service being accessible and properly configured within n8n.
  • No additional environment variables are explicitly required beyond the API authentication.

Troubleshooting

  • Common issues:
    • Authentication errors due to missing or invalid API key credential.
    • Performance delays or timeouts if "Include Total Count" is enabled on very large datasets.
    • Empty results if filters are too restrictive or incorrect.
  • Error messages:
    • Errors related to API connectivity or authorization will indicate issues with credentials or network.
    • Validation errors if "Limit" is set outside the allowed range (1-100).
  • Resolutions:
    • Verify the API key credential is correctly set up and has necessary permissions.
    • Adjust filters to be less restrictive or disable "Include Total Count" to improve performance.
    • Ensure "Limit" is within the valid range.

Links and References

Discussion