Skip to main content

Edit Voice Settings

Updates the default generation 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 edit settings for.
  • Stability (String) - Voice stability value from 0.0 to 1.0 (default: 0.5). Higher values make the voice more consistent.
  • Similarity Boost (String) - Similarity boost value from 0.0 to 1.0 (default: 0.75). Higher values make the voice closer to the original samples.

Options​

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

Outputs​

This node does not have outputs.

How It Works​

The Edit Voice Settings node updates a voice's default settings. When executed, the node:

  1. Validates that voice ID, stability, and similarity boost are provided
  2. Validates that both values are valid decimals between 0.0 and 1.0
  3. Either uses the provided connection or creates a new client with direct API key
  4. Calls the ElevenLabs API to update the voice settings
  5. Updates the voice's default generation parameters

Requirements​

  • Valid ElevenLabs API key (via Connect node or direct option)
  • Valid voice ID
  • Stability must be a decimal number between 0.0 and 1.0
  • Similarity boost must be a decimal number between 0.0 and 1.0

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."
  • Missing stability - "Stability cannot be empty. Please provide a value between 0.0 and 1.0."
  • Invalid stability format - "Stability must be a valid number between 0.0 and 1.0."
  • Missing similarity boost - "Similarity Boost cannot be empty. Please provide a value between 0.0 and 1.0."
  • Invalid similarity boost format - "Similarity Boost must be a valid number between 0.0 and 1.0."
  • Update failure - "Failed to edit voice settings: [error details]"

Usage Notes​

  • Stability controls voice consistency:
    • 0.0-0.3: More variable, expressive, emotional
    • 0.4-0.6: Balanced (recommended starting point)
    • 0.7-1.0: Very consistent, predictable, stable
  • Similarity Boost controls voice matching:
    • 0.0-0.3: More creative interpretation
    • 0.4-0.6: Balanced similarity
    • 0.7-1.0: Close match to original samples
  • Updates the default settings for future generations
  • These become the new defaults when using this voice
  • You can still override these in individual Text to Speech calls
  • Changes affect all future uses of the voice unless overridden
  • Useful for standardizing voice output across workflows

Example Use Cases​

  • Optimizing voice quality after testing different settings
  • Standardizing voice settings across a project
  • Adjusting voice consistency for different use cases
  • Fine-tuning voice characteristics
  • Setting up voices with preferred defaults
  • Fixing voice quality issues by adjusting settings