voices
voices

Get Voice Settings

Changed on

Returns the settings for a specific voice. "similarity_boost" corresponds to"Clarity + Similarity Enhancement" in the web app and "stability" corresponds to "Stability" slider in the web app.

get/v1/voices/{voice_id}/settings

Request

  • Base URL
    https://api.elevenlabs.io (the document declares no server; this is the origin it was published from)
  • URL
    https://api.elevenlabs.io/v1/voices/{voice_id}/settings
  • Auth
    none declared

Path parameters

voice_idstring required

Voice ID to be used, you can use https://api.elevenlabs.io/v1/voices to list all the available voices.

Example:21m00Tcm4TlvDq8ikWAM

Headers

xi-api-keystring nullable

Your API key. This is required by most endpoints to access our API programmatically. You can view your xi-api-key using the 'Profile' tab on the website.

Response

Successful Response

stabilitynumber nullable

Determines how stable the voice is and the randomness between each generation. Lower values introduce broader emotional range for the voice. Higher values can result in a monotonous voice with limited emotion.

use_speaker_boostboolean nullable

This setting boosts the similarity to the original speaker. Using this setting requires a slightly higher computational load, which in turn increases latency.

similarity_boostnumber nullable

Determines how closely the AI should adhere to the original voice when attempting to replicate it.

stylenumber nullable

Determines the style exaggeration of the voice. This setting attempts to amplify the style of the original speaker. It does consume additional computational resources and might increase latency if set to anything other than 0.

speednumber nullable

Adjusts the speed of the voice. A value of 1.0 is the default speed, while values less than 1.0 slow down the speech, and values greater than 1.0 speed it up.

clone_strengthnumber nullable

Controls how closely the voice matches the professional voice clone samples, from 0 (low) to 1 (high). We recommend 0 for most use cases. Increase this value only if you experience issues with the default settings. Only applies to professional voice clones fine-tuned for the selected v4 model.

Example response

{
  "similarity_boost": 1,
  "speed": 1,
  "stability": 1,
  "style": 0,
  "use_speaker_boost": true
}

Changes

  • 5ae19a7323a5Revision changes
    • info

      added the optional property to the response with the status

  • 5b595807512cRevision changes
    • info

      api operation id Get_voice_settings_v1_voices__voice_id__settings_get removed and replaced with get_voice_settings

    • info

      the response's property default value 0.75 was added for the status

    • info

      the response's property default value 1 was added for the status

    • info

      the response's property default value 0.5 was added for the status

    • info

      the response's property default value 0 was added for the status

    • info

      the response's property default value true was added for the status