Get Voices
Voice Library API Documentation
Overview
The Voice Library API allows you to retrieve voice data from our database. You can fetch all available voices or filter them by specific attributes.
Endpoint
GET https://tabbly.io/api/get-voices
Authentication
All requests must include a valid API key as a query parameter.
Required Parameter
api_key - Your unique API key provided by Tabbly
Example:
https://tabbly.io/api/get-voices?api_key=your_api_key_here
Optional Query Parameters
You can filter the results using the following optional parameters:
gender
Filter voices by gender
male, female
language
Filter voices by language
en, es, hi (codes mentioned in voice library section on the dashboard)
accent
Filter voices by accent
american, british
Examples
Basic Request (All Voices)
GET https://tabbly.io/api/get-voices?api_key=your_api_key_here
Filtered Request (Female English Voices)
GET https://tabbly.io/api/get-voices?api_key=your_api_key_here&gender=female&language=english
Filtered Request (American Accent)
GET https://tabbly.io/api/get-voices?api_key=your_api_key_here&accent=american
Response Format
The API returns data in JSON format.
Success Response
{
"status": "success",
"count": 2,
"voices": [
{
"id": 1,
"name": "Sarah",
"audio_url": "https://example.com/voices/sarah.mp3",
"per_min_price": "5.00",
"language": "english",
"gender": "female",
"accent": "american",
"created_at": "2025-02-15 12:30:45"
},
{
"id": 2,
"name": "John",
"audio_url": "https://example.com/voices/john.mp3",
"per_min_price": "4.50",
"language": "english",
"gender": "male",
"accent": "british",
"created_at": "2025-02-16 09:15:20"
}
]
}
Error Responses
Missing API Key (400 Bad Request)
{ "error": "API key is required" }
Invalid API Key (401 Unauthorized)
{ "error": "Invalid API key" }
Server Error (500 Internal Server Error)
{ "error": "Database error: [error message]" }
Last updated