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
}
'import requests
url = "https://api.bland.ai/v1/voices/{id}/settings"
payload = {
"consistency": 123,
"expressiveness": 123,
"boost_language_consistency": True
}
headers = {
"authorization": "<authorization>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {authorization: '<authorization>', 'Content-Type': 'application/json'},
body: JSON.stringify({consistency: 123, expressiveness: 123, boost_language_consistency: true})
};
fetch('https://api.bland.ai/v1/voices/{id}/settings', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.bland.ai/v1/voices/{id}/settings",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'consistency' => 123,
'expressiveness' => 123,
'boost_language_consistency' => true
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"authorization: <authorization>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.bland.ai/v1/voices/{id}/settings"
payload := strings.NewReader("{\n \"consistency\": 123,\n \"expressiveness\": 123,\n \"boost_language_consistency\": true\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("authorization", "<authorization>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.bland.ai/v1/voices/{id}/settings")
.header("authorization", "<authorization>")
.header("Content-Type", "application/json")
.body("{\n \"consistency\": 123,\n \"expressiveness\": 123,\n \"boost_language_consistency\": true\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bland.ai/v1/voices/{id}/settings")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["authorization"] = '<authorization>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"consistency\": 123,\n \"expressiveness\": 123,\n \"boost_language_consistency\": true\n}"
response = http.request(request)
puts response.read_body{
"consistency": 16,
"expressiveness": 0.8,
"service": "BTTS_V2"
}
{
"boost_language_consistency": true,
"service": "BTTS_V3"
}
{
"data": null,
"errors": [
{
"error": "INVALID_REQUEST",
"message": "At least one of consistency, expressiveness or boost_language_consistency must be provided"
}
]
}
{
"data": null,
"errors": [
{ "error": "INVALID_CONSISTENCY", "message": "consistency must be a number between 0 and 64" }
]
}
Voices
Update Voice Settings
Update the consistency/expressiveness defaults on a voice you own.
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
}
'import requests
url = "https://api.bland.ai/v1/voices/{id}/settings"
payload = {
"consistency": 123,
"expressiveness": 123,
"boost_language_consistency": True
}
headers = {
"authorization": "<authorization>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {authorization: '<authorization>', 'Content-Type': 'application/json'},
body: JSON.stringify({consistency: 123, expressiveness: 123, boost_language_consistency: true})
};
fetch('https://api.bland.ai/v1/voices/{id}/settings', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.bland.ai/v1/voices/{id}/settings",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'consistency' => 123,
'expressiveness' => 123,
'boost_language_consistency' => true
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"authorization: <authorization>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.bland.ai/v1/voices/{id}/settings"
payload := strings.NewReader("{\n \"consistency\": 123,\n \"expressiveness\": 123,\n \"boost_language_consistency\": true\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("authorization", "<authorization>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.bland.ai/v1/voices/{id}/settings")
.header("authorization", "<authorization>")
.header("Content-Type", "application/json")
.body("{\n \"consistency\": 123,\n \"expressiveness\": 123,\n \"boost_language_consistency\": true\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bland.ai/v1/voices/{id}/settings")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["authorization"] = '<authorization>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"consistency\": 123,\n \"expressiveness\": 123,\n \"boost_language_consistency\": true\n}"
response = http.request(request)
puts response.read_body{
"consistency": 16,
"expressiveness": 0.8,
"service": "BTTS_V2"
}
{
"boost_language_consistency": true,
"service": "BTTS_V3"
}
{
"data": null,
"errors": [
{
"error": "INVALID_REQUEST",
"message": "At least one of consistency, expressiveness or boost_language_consistency must be provided"
}
]
}
{
"data": null,
"errors": [
{ "error": "INVALID_CONSISTENCY", "message": "consistency must be a number between 0 and 64" }
]
}
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 thisPOST /settings form.
At least one of the body fields must be provided.
Headers
string
required
Your API key for authentication.
Path Parameters
string
required
UUID of the voice.
Body Parameters
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.
number
Default expressiveness for V1 and V2 voices. 0-1 float.
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:number
number
string
The engine identifier of the voice.
boolean
string
{
"consistency": 16,
"expressiveness": 0.8,
"service": "BTTS_V2"
}
{
"boost_language_consistency": true,
"service": "BTTS_V3"
}
{
"data": null,
"errors": [
{
"error": "INVALID_REQUEST",
"message": "At least one of consistency, expressiveness or boost_language_consistency must be provided"
}
]
}
{
"data": null,
"errors": [
{ "error": "INVALID_CONSISTENCY", "message": "consistency must be a number between 0 and 64" }
]
}
Docs for agents: llms.txt
Was this page helpful?
⌘I