Add Library Voice
curl --request POST \
--url https://api.bland.ai/v1/voices/library/add/{id} \
--header 'authorization: <authorization>'import requests
url = "https://api.bland.ai/v1/voices/library/add/{id}"
headers = {"authorization": "<authorization>"}
response = requests.post(url, headers=headers)
print(response.text)const options = {method: 'POST', headers: {authorization: '<authorization>'}};
fetch('https://api.bland.ai/v1/voices/library/add/{id}', 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/library/add/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
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/library/add/{id}"
req, _ := http.NewRequest("POST", 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.post("https://api.bland.ai/v1/voices/library/add/{id}")
.header("authorization", "<authorization>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bland.ai/v1/voices/library/add/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["authorization"] = '<authorization>'
response = http.request(request)
puts response.read_body{
"status": "success",
"message": "Voice is in your library",
"voice": {
"id": "73d4c04b-1e15-4272-9c7f-8d2955914ba9",
"name": "StephenD_v1 (published)",
"description": null,
"public": false,
"ratings": 0,
"tags": ["Beige Clone V2", "male"],
"user_id": "fea2a74f-9bd7-4b5d-a52e-c3c1a3f58bb0",
"voice_id": "ff595c98-da38-4617-ada3-df42561a2379",
"service": "BTTS_V2",
"finetuned": false,
"consistency": null,
"expressiveness": null,
"voice_meta": null,
"is_creator_voice": false
}
}
{
"data": null,
"errors": [
{ "error": "Rate Limit Exceeded", "message": "Too many library adds, please try again later." }
]
}
Discovery
Add Library Voice
Add a shared library voice to your org so it can be used in your calls and TTS.
POST
/
v1
/
voices
/
library
/
add
/
{id}
Add Library Voice
curl --request POST \
--url https://api.bland.ai/v1/voices/library/add/{id} \
--header 'authorization: <authorization>'import requests
url = "https://api.bland.ai/v1/voices/library/add/{id}"
headers = {"authorization": "<authorization>"}
response = requests.post(url, headers=headers)
print(response.text)const options = {method: 'POST', headers: {authorization: '<authorization>'}};
fetch('https://api.bland.ai/v1/voices/library/add/{id}', 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/library/add/{id}",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
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/library/add/{id}"
req, _ := http.NewRequest("POST", 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.post("https://api.bland.ai/v1/voices/library/add/{id}")
.header("authorization", "<authorization>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bland.ai/v1/voices/library/add/{id}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["authorization"] = '<authorization>'
response = http.request(request)
puts response.read_body{
"status": "success",
"message": "Voice is in your library",
"voice": {
"id": "73d4c04b-1e15-4272-9c7f-8d2955914ba9",
"name": "StephenD_v1 (published)",
"description": null,
"public": false,
"ratings": 0,
"tags": ["Beige Clone V2", "male"],
"user_id": "fea2a74f-9bd7-4b5d-a52e-c3c1a3f58bb0",
"voice_id": "ff595c98-da38-4617-ada3-df42561a2379",
"service": "BTTS_V2",
"finetuned": false,
"consistency": null,
"expressiveness": null,
"voice_meta": null,
"is_creator_voice": false
}
}
{
"data": null,
"errors": [
{ "error": "Rate Limit Exceeded", "message": "Too many library adds, please try again later." }
]
}
Overview
Adds a voice from the public Bland voice library to your org’s voice list. Once added, the voice can be used like any other voice you own: passed to Speak, configured via Update Voice Config, renamed, and so on. The original library voice is unchanged. The endpoint returns a new voice record that lives in your org and points at the same underlying model. This call is throttled to 30 add operations per minute per org.Headers
string
required
Your API key for authentication.
Path Parameters
string
required
UUID of the shared voice to add.
Response
string
success on success.string
Human-readable confirmation.
object
The newly added voice in your org. See Get Voice for the field list. The
id is unique to your org, the voice_id field points at the underlying model.{
"status": "success",
"message": "Voice is in your library",
"voice": {
"id": "73d4c04b-1e15-4272-9c7f-8d2955914ba9",
"name": "StephenD_v1 (published)",
"description": null,
"public": false,
"ratings": 0,
"tags": ["Beige Clone V2", "male"],
"user_id": "fea2a74f-9bd7-4b5d-a52e-c3c1a3f58bb0",
"voice_id": "ff595c98-da38-4617-ada3-df42561a2379",
"service": "BTTS_V2",
"finetuned": false,
"consistency": null,
"expressiveness": null,
"voice_meta": null,
"is_creator_voice": false
}
}
{
"data": null,
"errors": [
{ "error": "Rate Limit Exceeded", "message": "Too many library adds, please try again later." }
]
}
Docs for agents: llms.txt
Was this page helpful?
⌘I