ElevenLabs icon

ElevenLabs

Generate natural-sounding speech using ElevenLabs AI
Join our community

Actions13

Overview

The "Get Voice Details" operation in the ElevenLabs node retrieves detailed information about a specific generated voice using its unique identifier. This is useful for users who want to inspect or verify the properties and settings of a voice they have created or are using within the ElevenLabs platform. For example, a user might want to confirm the characteristics or configuration of a voice before generating speech with it or managing their voice assets.

Properties

Name Meaning
API Key Notice A notice informing the user that an API key from ElevenLabs is required to use this node. It includes a link to obtain the key from the ElevenLabs dashboard.
With Settings Boolean option indicating whether to include the voice's settings in the returned details. If true, the response will contain additional configuration data about the voice.
Generation Voice ID The unique identifier (generated_voice_id) of the voice whose details are being requested. This is a required string input.

Output

The output JSON contains detailed information about the specified generated voice. If the "With Settings" property is enabled, the output will also include the voice's configuration settings. The exact structure depends on the ElevenLabs API response but typically includes fields such as voice name, description, language, and any custom settings related to voice generation.

If the node supports binary data output (not explicitly shown here), it would generally represent audio files or similar media generated by the voice, but for this operation, the focus is on metadata retrieval.

Dependencies

  • Requires an API key credential from ElevenLabs to authenticate requests.
  • The node sends HTTP requests to the ElevenLabs API endpoint at https://api.elevenlabs.io/v1.
  • Proper network connectivity to the ElevenLabs service is necessary.

Troubleshooting

  • Missing or invalid API key: The node will fail if the API key is not provided or is incorrect. Ensure you have a valid API key from the ElevenLabs dashboard.
  • Invalid generated_voice_id: If the provided voice ID does not exist or is malformed, the API will return an error. Verify the ID is correct.
  • Network issues: Connectivity problems can cause request failures. Check your internet connection and firewall settings.
  • Permission errors: If your API key lacks permissions to access voice details, the request will be denied. Confirm your API key has appropriate scopes.

Links and References

Discussion