Skip to main content
GET
/
v1
/
voices
/
{id}
/
settings
Get Voice Settings
curl --request GET \
  --url https://api.bland.ai/v1/voices/{id}/settings \
  --header 'authorization: <authorization>'
{
  "consistency": 8,
  "expressiveness": 1,
  "service": "BTTS_V2",
  "limits": {
    "consistency": { "min": 0, "max": 64 },
    "expressiveness": { "min": 0, "max": 1 }
  }
}

​
Overview

Returns the current synthesis defaults stored on a voice you own, plus the valid range for each tunable so callers do not have to discover the bounds by trial and error. Different engines expose different settings:
  • BTTS V1: consistency (0-1 float) and expressiveness (0-1 float).
  • BTTS V2: consistency (0-64 integer, lower is more consistent) and expressiveness (0-1 float).
  • BTTS V3: a single boolean boost_language_consistency.
To update these settings, use Update Voice Settings.

​
Headers

​
authorization
string
required
Your API key for authentication.

​
Path Parameters

​
id
string
required
UUID of the voice.

​
Response

For V1 and V2 voices:
​
consistency
number
​
expressiveness
number
​
service
string
The engine identifier, e.g. BTTS_V2.
​
limits
object
Valid ranges for the tunables.
For V3 voices:
​
boost_language_consistency
boolean
​
service
string
BTTS_V3.
{
  "consistency": 8,
  "expressiveness": 1,
  "service": "BTTS_V2",
  "limits": {
    "consistency": { "min": 0, "max": 64 },
    "expressiveness": { "min": 0, "max": 1 }
  }
}
Docs for agents: llms.txt