Samples
Add Voice Sample
Append training samples to an existing voice clone you own.
POST
/
v1
/
voices
/
samples
Add Voice Sample
curl --request POST \
--url https://api.bland.ai/v1/voices/samples \
--header 'Content-Type: multipart/form-data' \
--header 'authorization: <authorization>' \
--form 'voice_id=<string>'import requests
url = "https://api.bland.ai/v1/voices/samples"
payload = "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"voice_id\"\r\n\r\n<string>\r\n-----011000010111000001101001--"
headers = {
"authorization": "<authorization>",
"Content-Type": "multipart/form-data"
}
response = requests.post(url, data=payload, headers=headers)
print(response.text)const form = new FormData();
form.append('voice_id', '<string>');
const options = {method: 'POST', headers: {authorization: '<authorization>'}};
options.body = form;
fetch('https://api.bland.ai/v1/voices/samples', 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/samples",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"voice_id\"\r\n\r\n<string>\r\n-----011000010111000001101001--",
CURLOPT_HTTPHEADER => [
"Content-Type: multipart/form-data",
"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/samples"
payload := strings.NewReader("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"voice_id\"\r\n\r\n<string>\r\n-----011000010111000001101001--")
req, _ := http.NewRequest("POST", url, payload)
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/samples")
.header("authorization", "<authorization>")
.body("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"voice_id\"\r\n\r\n<string>\r\n-----011000010111000001101001--")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bland.ai/v1/voices/samples")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["authorization"] = '<authorization>'
request.body = "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"voice_id\"\r\n\r\n<string>\r\n-----011000010111000001101001--"
response = http.request(request)
puts response.read_body{
"status": "success",
"samples": [
{
"id": "d15b199a-1b79-4664-9a9a-b149ee3b136a",
"voice_id": "73d4c04b-1e15-4272-9c7f-8d2955914ba9",
"transcription": null,
"duration_seconds": 11.4,
"created_at": "2026-06-22T21:34:31.347Z"
}
]
}
{
"data": null,
"errors": [
{ "error": "BAD_REQUEST", "message": "No audio files provided" }
]
}
{
"data": null,
"errors": [
{ "error": "INTERNAL_SERVER_ERROR", "message": "Adding samples is only supported for BTTS voices" }
]
}
{
"data": null,
"errors": [
{ "error": "Validation Error", "message": "Cannot add 2 sample(s). Voice already has 4 samples. Maximum allowed is 5 samples per voice." }
]
}
Overview
Appends one or more audio samples to an existing voice clone, retraining the voice on the expanded sample set. Sample limits depend on the voice’s engine. BTTS V1 voices accept up to 5 samples total. BTTS V2 and BTTS V3 voices are single-sample by design and do not accept additional samples; use Clone Voice to create a new voice instead. Sent asmultipart/form-data.
Headers
Form Fields
WAV files to append. Each file 1-60 seconds, max 10 MB. The combined sample count after this call cannot exceed 5 for a V1 voice.
Response
The samples currently attached to the voice after the update. See List Voice Samples for field shape.
{
"status": "success",
"samples": [
{
"id": "d15b199a-1b79-4664-9a9a-b149ee3b136a",
"voice_id": "73d4c04b-1e15-4272-9c7f-8d2955914ba9",
"transcription": null,
"duration_seconds": 11.4,
"created_at": "2026-06-22T21:34:31.347Z"
}
]
}
{
"data": null,
"errors": [
{ "error": "BAD_REQUEST", "message": "No audio files provided" }
]
}
{
"data": null,
"errors": [
{ "error": "INTERNAL_SERVER_ERROR", "message": "Adding samples is only supported for BTTS voices" }
]
}
{
"data": null,
"errors": [
{ "error": "Validation Error", "message": "Cannot add 2 sample(s). Voice already has 4 samples. Maximum allowed is 5 samples per voice." }
]
}
Docs for agents: llms.txt
Was this page helpful?
⌘I
Add Voice Sample
curl --request POST \
--url https://api.bland.ai/v1/voices/samples \
--header 'Content-Type: multipart/form-data' \
--header 'authorization: <authorization>' \
--form 'voice_id=<string>'import requests
url = "https://api.bland.ai/v1/voices/samples"
payload = "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"voice_id\"\r\n\r\n<string>\r\n-----011000010111000001101001--"
headers = {
"authorization": "<authorization>",
"Content-Type": "multipart/form-data"
}
response = requests.post(url, data=payload, headers=headers)
print(response.text)const form = new FormData();
form.append('voice_id', '<string>');
const options = {method: 'POST', headers: {authorization: '<authorization>'}};
options.body = form;
fetch('https://api.bland.ai/v1/voices/samples', 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/samples",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"voice_id\"\r\n\r\n<string>\r\n-----011000010111000001101001--",
CURLOPT_HTTPHEADER => [
"Content-Type: multipart/form-data",
"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/samples"
payload := strings.NewReader("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"voice_id\"\r\n\r\n<string>\r\n-----011000010111000001101001--")
req, _ := http.NewRequest("POST", url, payload)
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/samples")
.header("authorization", "<authorization>")
.body("-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"voice_id\"\r\n\r\n<string>\r\n-----011000010111000001101001--")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bland.ai/v1/voices/samples")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["authorization"] = '<authorization>'
request.body = "-----011000010111000001101001\r\nContent-Disposition: form-data; name=\"voice_id\"\r\n\r\n<string>\r\n-----011000010111000001101001--"
response = http.request(request)
puts response.read_body{
"status": "success",
"samples": [
{
"id": "d15b199a-1b79-4664-9a9a-b149ee3b136a",
"voice_id": "73d4c04b-1e15-4272-9c7f-8d2955914ba9",
"transcription": null,
"duration_seconds": 11.4,
"created_at": "2026-06-22T21:34:31.347Z"
}
]
}
{
"data": null,
"errors": [
{ "error": "BAD_REQUEST", "message": "No audio files provided" }
]
}
{
"data": null,
"errors": [
{ "error": "INTERNAL_SERVER_ERROR", "message": "Adding samples is only supported for BTTS voices" }
]
}
{
"data": null,
"errors": [
{ "error": "Validation Error", "message": "Cannot add 2 sample(s). Voice already has 4 samples. Maximum allowed is 5 samples per voice." }
]
}