शुरुआत करना

अपनी पहली API रिक्वेस्ट करने के लिए ज़रूरी हर चीज़

बेस URL

Moknah आपके इस्तेमाल के तरीके के आधार पर दो तरह के एंडपॉइंट देता है:

स्टैंडर्ड REST API (अलग-अलग अनुरोधों के लिए):

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

रियल-टाइम WebSocket API (लगातार स्ट्रीमिंग के लिए):

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

प्रमाणीकरण

Moknah API इस्तेमाल करता है API कीज़ ऑथेंटिकेशन के लिए। अपनी API की (key) को इसमें शामिल करें। Authorization का इस्तेमाल करके हेडर वाहक हर HTTP रिक्वेस्ट और WebSocket हैंडशेक के साथ स्कीम।

Authorization: Bearer YOUR_API_KEY

अपनी API की (API Key) प्राप्त करना

1. अपने अकाउंट में लॉग इन करें मोकनाह डैशबोर्ड
2. प्रो प्लान सब्सक्राइब करें या संपर्क करें बिक्री एंटरप्राइज़ एक्सेस के लिए।
3. पर जाएँ API
4. क्लिक करें API कीज़ मैनेज करें
5. क्लिक करें नई चाबी
6. अपनी की (key) को कॉपी करें और सुरक्षित रूप से स्टोर करें।

HTTP का एक छोटा सा उदाहरण

यहाँ स्टैंडर्ड 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("ऑडियो सेव हो गया!")
else:
    print(f"त्रुटि: {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();
    // ऑडियो ब्लॉब का इस्तेमाल करें
    console.log("ऑडियो तैयार हो गया!");
} else {
    const error = await response.json();
    console.error(error);
}

प्रतिक्रिया का प्रारूप

सफलता के जवाब

सफल रिस्पॉन्स एंडपॉइंट के आधार पर अलग-अलग होते हैं:

• TTS जनरेट करें (POST): पूरा बाइनरी ऑडियो डेटा (audio/mpeg) देता है
• TTS स्ट्रीम (WSS): बाइनरी MP3 चंक्स (हिस्सों) को लगातार स्ट्रीम करता है, जैसे-जैसे वे बनते जाते हैं।
• अन्य एंडपॉइंट्स: स्ट्रक्चर्ड JSON डेटा देता है

रेट लिमिट हेडर (सिर्फ़ HTTP)

हर HTTP रिस्पॉन्स में रेट लिमिट की जानकारी शामिल होती है (WebSockets कनेक्शन बंद करके लिमिट लागू करते हैं):

सामान्य एरर कोड

अगले कदम

अब जब आपका सेटअप हो गया है, तो उपलब्ध एंडपॉइंट्स को देखें: