Skip to main content
POST
/
v1
/
voices
/
{id}
/
settings
Update Voice Settings
curl --request POST \
  --url https://api.bland.ai/v1/voices/{id}/settings \
  --header 'Content-Type: application/json' \
  --header 'authorization: <authorization>' \
  --data '
{
  "consistency": 123,
  "expressiveness": 123,
  "boost_language_consistency": true
}
'
{
  "consistency": 16,
  "expressiveness": 0.8,
  "service": "BTTS_V2"
}

​
Overview

Updates one or more synthesis defaults on a voice you own. Equivalent to Update Voice Config, kept under both verbs and paths for backwards compatibility. New integrations should use this POST /settings form. At least one of the body fields must be provided.

​
Headers

​
authorization
string
required
Your API key for authentication.

​
Path Parameters

​
id
string
required
UUID of the voice.

​
Body Parameters

​
consistency
number
Default consistency for V1 and V2 voices. V1: 0-1 float (higher is more consistent). V2: 0-64 integer (lower is more consistent). Reject values outside that range.
​
expressiveness
number
Default expressiveness for V1 and V2 voices. 0-1 float.
​
boost_language_consistency
boolean
Boost flag for V3 voices only. true adds language-consistency prompting at the cost of some flexibility for code-switching. Disable if your agent needs to speak languages outside the source sample.

​
Response

Echoes back the resolved settings on success. For V1 and V2 voices:
​
consistency
number
​
expressiveness
number
​
service
string
The engine identifier of the voice.
For V3 voices:
​
boost_language_consistency
boolean
​
service
string
To see the rest of the voice’s fields after an update, call Get Voice. 
{
  "consistency": 16,
  "expressiveness": 0.8,
  "service": "BTTS_V2"
}
Docs for agents: llms.txt