Skip to main content

Get Voice Settings

Retrieves the current settings (stability and similarity boost) for a specific voice.

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 settings for.

Options​

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

Outputs​

  • Voice Settings (Object) - Voice settings including:
    • stability - Voice stability value (0.0 to 1.0)
    • similarity_boost - Voice similarity boost value (0.0 to 1.0)

How It Works​

The Get Voice Settings node retrieves a voice's generation settings. 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 settings
  4. Returns the stability and similarity boost values

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 settings: [error details]"

Usage Notes​

  • Returns the default generation settings for a voice
  • These settings control how the voice sounds when generating speech
  • Stability affects voice consistency and variation
  • Similarity boost affects how closely output matches the original voice samples
  • You can override these settings in Text to Speech and Speech to Speech nodes
  • Useful for understanding current voice configuration
  • Pre-made voices have optimized default settings

Example Use Cases​

  • Checking current settings before generating speech
  • Documenting voice configurations
  • Comparing settings across different voices
  • Debugging voice quality issues
  • Building voice management interfaces
  • Retrieving baseline settings to modify