List Voices
curl --request GET \
--url https://api.bland.ai/v1/voices \
--header 'authorization: <authorization>'import requests
url = "https://api.bland.ai/v1/voices"
headers = {"authorization": "<authorization>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {authorization: '<authorization>'}};
fetch('https://api.bland.ai/v1/voices', 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",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"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"
"net/http"
"io"
)
func main() {
url := "https://api.bland.ai/v1/voices"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("authorization", "<authorization>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.bland.ai/v1/voices")
.header("authorization", "<authorization>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bland.ai/v1/voices")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["authorization"] = '<authorization>'
response = http.request(request)
puts response.read_body{
"voices": [
{
"id": "d4610ec1-933d-44c9-a05f-53df2437808d",
"name": "maya",
"description": "Young American Female",
"public": true,
"tags": ["english", "soft", "Bland Curated"],
"user_id": null,
"voice_id": "5134ee24-7d14-49a4-8aff-2215d295b6cc",
"service": "BTTS_V2",
"finetuned": false,
"is_creator_voice": false,
"ratings": 1234,
"total_ratings": 1234,
"average_rating": 4.6,
"my_rating": null,
"creator_display_name": null
},
{
"id": "5f29c646-1881-4882-8d8c-8616a2d5ce9c",
"name": "MyClone",
"description": null,
"public": false,
"tags": ["Beige Clone V3", "cloned", "female"],
"user_id": "ffcf63aa-6298-471f-91ad-5d2653812042",
"voice_id": "c18a1cd5-91ef-4b06-841a-e58b8b487e8c",
"service": "BTTS_V3",
"finetuned": false,
"is_creator_voice": false,
"ratings": 0,
"total_ratings": 0,
"average_rating": 0,
"my_rating": null,
"creator_display_name": null
}
]
}
Voices
List Voices
List all voices available to your account.
GET
/
v1
/
voices
List Voices
curl --request GET \
--url https://api.bland.ai/v1/voices \
--header 'authorization: <authorization>'import requests
url = "https://api.bland.ai/v1/voices"
headers = {"authorization": "<authorization>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {authorization: '<authorization>'}};
fetch('https://api.bland.ai/v1/voices', 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",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"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"
"net/http"
"io"
)
func main() {
url := "https://api.bland.ai/v1/voices"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("authorization", "<authorization>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.bland.ai/v1/voices")
.header("authorization", "<authorization>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bland.ai/v1/voices")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["authorization"] = '<authorization>'
response = http.request(request)
puts response.read_body{
"voices": [
{
"id": "d4610ec1-933d-44c9-a05f-53df2437808d",
"name": "maya",
"description": "Young American Female",
"public": true,
"tags": ["english", "soft", "Bland Curated"],
"user_id": null,
"voice_id": "5134ee24-7d14-49a4-8aff-2215d295b6cc",
"service": "BTTS_V2",
"finetuned": false,
"is_creator_voice": false,
"ratings": 1234,
"total_ratings": 1234,
"average_rating": 4.6,
"my_rating": null,
"creator_display_name": null
},
{
"id": "5f29c646-1881-4882-8d8c-8616a2d5ce9c",
"name": "MyClone",
"description": null,
"public": false,
"tags": ["Beige Clone V3", "cloned", "female"],
"user_id": "ffcf63aa-6298-471f-91ad-5d2653812042",
"voice_id": "c18a1cd5-91ef-4b06-841a-e58b8b487e8c",
"service": "BTTS_V3",
"finetuned": false,
"is_creator_voice": false,
"ratings": 0,
"total_ratings": 0,
"average_rating": 0,
"my_rating": null,
"creator_display_name": null
}
]
}
Overview
Returns every voice your account can use: Bland’s curated default voices, voices you have cloned, voices you have added to your library from the public catalog, and voices owned by your org. For just the publicly-shared library, use List Shared Voices instead.Headers
Your API key for authentication.
Response
Array of voices.
Show Voice fields
Show Voice fields
Display name. For curated default voices this can also be used in the
voice field when sending calls.Short human-readable description of the voice.
true for shared library voices and Bland curated voices, false for voices private to your org.Labels describing the voice (language, style, source). Bland’s recommended curated voices carry the
"Bland Curated" tag.Owner UUID.
null for curated default voices.Underlying model identifier. Format varies by engine; treat as opaque.
Engine identifier. One of
BTTS, BTTS_V2, BTTS_V3, or LEGACY.true if the voice has been fine-tuned past the base clone.true for voices in the Bland creator program. Creator voices may carry a per-character fee in addition to synthesis cost.Total number of ratings the voice has received.
Alias of
ratings returned for backwards compatibility.Average rating, 0-5.
The calling user’s rating for this voice, if any.
null when the caller has not rated it. Submit via Rate Voice.Creator name for voices in the creator program.
null otherwise.{
"voices": [
{
"id": "d4610ec1-933d-44c9-a05f-53df2437808d",
"name": "maya",
"description": "Young American Female",
"public": true,
"tags": ["english", "soft", "Bland Curated"],
"user_id": null,
"voice_id": "5134ee24-7d14-49a4-8aff-2215d295b6cc",
"service": "BTTS_V2",
"finetuned": false,
"is_creator_voice": false,
"ratings": 1234,
"total_ratings": 1234,
"average_rating": 4.6,
"my_rating": null,
"creator_display_name": null
},
{
"id": "5f29c646-1881-4882-8d8c-8616a2d5ce9c",
"name": "MyClone",
"description": null,
"public": false,
"tags": ["Beige Clone V3", "cloned", "female"],
"user_id": "ffcf63aa-6298-471f-91ad-5d2653812042",
"voice_id": "c18a1cd5-91ef-4b06-841a-e58b8b487e8c",
"service": "BTTS_V3",
"finetuned": false,
"is_creator_voice": false,
"ratings": 0,
"total_ratings": 0,
"average_rating": 0,
"my_rating": null,
"creator_display_name": null
}
]
}
Docs for agents: llms.txt
Was this page helpful?
⌘I