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:

Parameter
Description
Example

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