Skip to main content
GET
Get Voices
Retrieve a list of all available voices for text-to-speech synthesis.

Authentication

Requires API key authentication via x-api-key header.

Response

Returns an array of voice objects.

Response Schema

Each voice object contains:

Usage

Use the voice_id from the response in text-to-speech generation endpoints:
  • POST /text-to-speech/:model_id - Include voice_id in the request body
  • WS /text-to-speech - Include voice_id in the WebSocket message

Voice Types

Voices can be categorized by:
  • Dialect: fusha (Modern Standard Arabic), emirati, najdi, hijazi, kuwaiti, egyptian, british, etc.
  • Gender: male or female
  • Age: middle or elderly
  • Languages: Supported language codes (e.g., ar for Arabic, en for English)
Custom Voices: Some voices may have null values for certain fields. These are typically custom user-created voices. The voice_id can still be used in text-to-speech requests regardless of these field values.
Caching: Voice information doesn’t change frequently. Consider caching the voice list to reduce API calls and improve application performance.

Authorizations

x-api-key
string
header
required

API key for authentication

Response

List of available voices

voice_id
string
required

Unique identifier for the voice (used in text-to-speech requests)

name
string
required

Human-readable name of the voice

languages
string[]
required

List of language codes supported by the voice (e.g., ["ar", "en"])

dialect
string[]
required

List of dialects supported by the voice (e.g., ["fusha", "emirati", "najdi"])

sample_url
string<uri>
required

URL to an audio sample of the voice

description
string | null

Detailed description of the voice characteristics

gender
enum<string> | null

Gender of the voice

Available options:
male,
female
age
enum<string> | null

Age category of the voice

Available options:
middle,
elderly
type
enum<string> | null

Voice type

Available options:
neural