Skip to main content

Get Voice

Retrieves detailed information for a specific voice by its ID, including settings and metadata.

Common Properties​

  • Name - The custom name of the node.
  • Color - The custom color of the node.
  • Delay Before (sec) - Waits in seconds before executing the node.
  • Delay After (sec) - Waits in seconds after executing node.
  • Continue On Error - Automation will continue regardless of any error. The default value is false.

Inputs​

  • Connection Id (String) - Connection ID from the Connect node. Optional if you provide API Key directly.
  • Voice ID (String) - ID of the voice to retrieve details for.

Options​

  • API Key - Your ElevenLabs AI API key. Optional if using Connection ID.

Outputs​

  • Voice (Object) - Detailed voice information including:
    • voice_id - Unique identifier
    • name - Voice name
    • description - Voice description
    • category - Voice category
    • labels - Voice characteristics
    • settings - Voice generation settings (stability, similarity_boost)
    • samples - Audio samples used for the voice
    • preview_url - Preview audio URL

How It Works​

The Get Voice node retrieves detailed information about a specific voice. When executed, the node:

  1. Validates that a voice ID is provided
  2. Either uses the provided connection or creates a new client with direct API key
  3. Calls the ElevenLabs API to retrieve the voice with settings
  4. Returns the complete voice details including generation settings

Requirements​

  • Valid ElevenLabs API key (via Connect node or direct option)
  • Valid voice ID

Error Handling​

The node will return specific errors in the following cases:

  • Missing voice ID - "Voice ID cannot be empty. Please provide a valid ElevenLabs voice ID."
  • Retrieval failure - "Failed to retrieve voice: [error details]"

Usage Notes​

  • Returns more detailed information than Get Voices, including settings
  • Useful for inspecting voice configuration before using it
  • The settings indicate the default stability and similarity boost values for the voice
  • Samples show which audio files were used to create custom voices
  • For pre-made ElevenLabs voices, samples may not be available
  • Voice IDs can be obtained from the Get Voices node
  • Use this to verify a voice exists before using it in speech generation

Example Use Cases​

  • Inspecting custom voice settings before generating speech
  • Verifying voice configuration
  • Retrieving default settings for a voice
  • Checking which audio samples were used for a cloned voice
  • Debugging voice-related issues
  • Building voice management interfaces
  • Documenting voice configurations