List TTS Generations
curl --request GET \
--url https://api.bland.ai/v1/speak/samples \
--header 'authorization: <authorization>'import requests
url = "https://api.bland.ai/v1/speak/samples"
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/speak/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/speak/samples",
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/speak/samples"
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/speak/samples")
.header("authorization", "<authorization>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bland.ai/v1/speak/samples")
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{
"data": [
{
"id": "a3f8c2d1-4b5e-6789-0abc-def012345678",
"org_id": "9e1d2c3b-4a5f-6780-bcde-f01234567890",
"user_id": "5c6d7e8f-9012-3456-789a-bcdef0123456",
"text": "Hello, this is a test of the text-to-speech system.",
"voice_id": "2b3c4d5e-6f70-8901-2345-6789abcdef01",
"output_format": "pcm_44100",
"latency_ms": 1261,
"cost": 0.011,
"created_at": "2026-03-16T01:44:56.673Z"
}
],
"errors": null,
"total": 1,
"limit": 20,
"offset": 0
}
Generation History
List TTS Generations
List your stored text-to-speech generations.
GET
/
v1
/
speak
/
samples
List TTS Generations
curl --request GET \
--url https://api.bland.ai/v1/speak/samples \
--header 'authorization: <authorization>'import requests
url = "https://api.bland.ai/v1/speak/samples"
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/speak/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/speak/samples",
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/speak/samples"
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/speak/samples")
.header("authorization", "<authorization>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.bland.ai/v1/speak/samples")
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{
"data": [
{
"id": "a3f8c2d1-4b5e-6789-0abc-def012345678",
"org_id": "9e1d2c3b-4a5f-6780-bcde-f01234567890",
"user_id": "5c6d7e8f-9012-3456-789a-bcdef0123456",
"text": "Hello, this is a test of the text-to-speech system.",
"voice_id": "2b3c4d5e-6f70-8901-2345-6789abcdef01",
"output_format": "pcm_44100",
"latency_ms": 1261,
"cost": 0.011,
"created_at": "2026-03-16T01:44:56.673Z"
}
],
"errors": null,
"total": 1,
"limit": 20,
"offset": 0
}
Headers
string
required
Your API key for authentication.
Query Parameters
number
default:"20"
Number of generations to return.
number
default:"0"
Number of generations to skip for pagination.
string
Filter results to a specific voice.
Response
array
List of stored TTS generation objects.
Show Generation object
Show Generation object
string
Unique identifier for the generation.
string
The organization that created the generation.
string
The user that created the generation.
string
The text that was synthesized.
string
The voice used for synthesis.
string
The audio format of the generation (e.g.
pcm_44100).number
Time in milliseconds from request to first audio.
number
Cost in USD for this generation.
string
ISO 8601 timestamp of when the generation was created.
number
Total number of generations matching the query.
number
The limit applied to this request.
number
The offset applied to this request.
null | array
Any errors encountered, or
null if successful.{
"data": [
{
"id": "a3f8c2d1-4b5e-6789-0abc-def012345678",
"org_id": "9e1d2c3b-4a5f-6780-bcde-f01234567890",
"user_id": "5c6d7e8f-9012-3456-789a-bcdef0123456",
"text": "Hello, this is a test of the text-to-speech system.",
"voice_id": "2b3c4d5e-6f70-8901-2345-6789abcdef01",
"output_format": "pcm_44100",
"latency_ms": 1261,
"cost": 0.011,
"created_at": "2026-03-16T01:44:56.673Z"
}
],
"errors": null,
"total": 1,
"limit": 20,
"offset": 0
}
Docs for agents: llms.txt
Was this page helpful?
⌘I