Getting Started

Everything you need to make your first API request

Base URLs

Moknah provides two types of endpoints depending on your use case:

Standard REST API (for single requests):

https://moknah.io/api/v1/

Real-time WebSocket API (for continuous streaming):

wss://moknah.io/api/v1/

Authentication

The Moknah API uses API keys for authentication. Include your API key in the Authorization header using the Bearer scheme with every HTTP request and WebSocket handshake.

Authorization: Bearer YOUR_API_KEY

Getting Your API Key

1. Log in to your Moknah Dashboard
2. Subscribe to the Pro Plan or contact Sales for enterprise access.
3. Navigate to API
4. Click Manage API Keys
5. Click New Key
6. Copy and securely store your key

Quick HTTP Example

Here's a complete example to generate speech from text using the standard REST API:

curl -X POST "https://moknah.io/api/v1/tts/generate/" \
  -H "Authorization: Bearer your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "text": "مرحبا بك في منصة مكنة",
    "voice_id": 1
  }' \
  --output speech.mp3

import requests

response = requests.post(
    "https://moknah.io/api/v1/tts/generate/",
    headers={
        "Authorization": f"Bearer your_api_key",
    },
    json={
        "text": "مرحبا بك في منصة مكنة",
        "voice_id": 1
    }
)

if response.status_code == 200:
    with open("speech.mp3", "wb") as f:
        f.write(response.content)
    print("Audio saved!")
else:
    print(f"Error: {response.json()}")

const response = await fetch(
    'https://moknah.io/api/v1/tts/generate/',
    {
        method: 'POST',
        headers: {
            'Authorization': 'Bearer your_api_key',
            'Content-Type': 'application/json'
        },
        body: JSON.stringify({
            text: 'مرحبا بك في منصة مكنة',
            voice_id: 1
        })
    }
);

if (response.ok) {
    const blob = await response.blob();
    // Use the audio blob
    console.log("Audio generated!");
} else {
    const error = await response.json();
    console.error(error);
}

Response Format

Success Responses

Successful responses vary by endpoint:

• TTS Generate (POST): Returns complete binary audio data (audio/mpeg)
• TTS Stream (WSS): Streams binary MP3 chunks continuously as they are generated
• Other endpoints: Returns structured JSON data

Rate Limit Headers (HTTP Only)

Every HTTP response includes rate limit information (WebSockets enforce limits via connection closures):

Common Error Codes

Next Steps

Now that you're set up, explore the available endpoints: