Moknah Docs
Start free
API Reference

Voice List

Retrieve available voices for TTS

POST /api/v1/voices/

Returns a list of all voices the authenticated user is allowed to use with the Text-to-Speech API.

Authentication

Include your API key in the Authorization header as Bearer YOUR_API_KEY.

Request Body

Parameter Required Type Description
language optional string Language for voice names and badge values, e.g. ar, fr or zh-hans (also accepted as ?language= in the URL). A voice with no text in that language falls back to English, and so does a missing or unsupported code. The Content-Language response header shows the language used.
engine optional string Your API key lists the voices of its own type only (Standard or Advanced, chosen when the key was created). If you send engine, it must match the key's type.

Response

Field Type Description
voice_id integer Unique voice identifier
voice_name string Voice display name
voice_sample_url string URL to the voice sample audio file
voice_fees float Fee to use this voice (0 means free)
voice_badges object Additional metadata for the voice, e.g., language, gender, age, use case
voice_engine string standard or advanced. Standard engine voices use mode; Advanced engine voices use context, setting, style and pace. See Engines & Modes.

Example

curl "https://moknah.io/api/v1/voices/" \
  -H "Authorization: Bearer YOUR_API_KEY"
import requests

response = requests.post(
    "https://moknah.io/api/v1/voices/",
    headers={"Authorization": "Bearer YOUR_API_KEY"}
)

voices = response.json()
for voice in voices:
    print(voice["voice_name"], voice["voice_sample_url"])
const response = await fetch(
    'https://moknah.io/api/v1/voices/',
    {
        headers: { 'Authorization': 'Bearer YOUR_API_KEY' }
    }
);

const voices = await response.json();
console.log(voices);

Response Example

[
    {
        "voice_id": 1328,
        "voice_name": "Adnan",
        "voice_sample_url": "https://storage.moknah.io/media/voice_samples/Adnan.mp3",
        "voice_fees": 0.0,
        "voice_badges": {
            "language": "Arabic",
            "gender": "Male",
            "age": "Young Adult",
            "use_case": "Documentary, Audiobook, Article",
        },
        "voice_engine": "standard"
    }
]
API Support

For API-related questions or issues, contact us at api@moknah.io.