ElevenLabs icon

ElevenLabs

WIP

Actions13

Overview

The Get Voice Details operation of the ElevenLabs node retrieves detailed information about a specific generated voice from the ElevenLabs API. This is useful for users who need to programmatically access metadata or settings related to a particular voice, such as in automated content creation workflows, voice management dashboards, or when integrating voice features into other applications.

Practical examples:

  • Fetching and displaying details of a custom-generated voice in a dashboard.
  • Retrieving voice settings to audit or modify them in subsequent steps.
  • Integrating with other systems that require knowledge of available voices and their configurations.

Properties

Display Name Type Meaning
With Settings Boolean Whether to include detailed voice settings in the response. If enabled, more configuration data about the voice will be returned.
Generation Voice ID String The unique identifier (generated_voice_id) of the generated voice whose details are being requested. This is required.

Note: There is also a notice property providing beta status and links, but it does not affect execution.

Output

The output is a JSON object containing details about the specified generated voice. While the exact structure depends on the ElevenLabs API, typical fields may include:

{
  "voice_id": "string",
  "name": "string",
  "description": "string",
  "settings": { /* present if 'With Settings' is true */ },
  // ...other metadata fields
}
  • If With Settings is enabled, the settings field will provide additional configuration details about the voice.
  • No binary data is produced by this operation.

Dependencies

  • External Service: Requires access to the ElevenLabs API.
  • API Key: You must configure valid ElevenLabs API credentials in n8n under the name elevenLabsApi.
  • n8n Configuration: Ensure the node is properly authenticated and has network access to the ElevenLabs API endpoint.

Troubleshooting

Common Issues:

  • Missing or Invalid API Key: If the API key is missing or incorrect, authentication errors will occur. Make sure your credentials are set up correctly in n8n.
  • Invalid Generation Voice ID: Supplying an incorrect or non-existent Generation Voice ID will result in a "not found" error from the API.
  • Network Errors: Connectivity issues between n8n and the ElevenLabs API can cause failures.

Error Messages & Resolutions:

  • "401 Unauthorized": Check your ElevenLabs API credentials.
  • "404 Not Found": Verify the Generation Voice ID is correct and exists in your ElevenLabs account.
  • "400 Bad Request": Ensure all required properties are provided and valid.

Links and References

Discussion