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]"
  }