यूज़र गाइड API संदर्भ

स्पीच टू टेक्स्ट (STT) ट्रांसक्रिप्शन

टाइमस्टैम्प के साथ सटीक टेक्स्ट ट्रांसक्रिप्शन के लिए पहले से रिकॉर्ड की गई ऑडियो फ़ाइलों को एसिंक्रोनस रूप से अपलोड करें।

क्योंकि बड़ी ऑडियो फ़ाइलों को प्रोसेस होने में कई मिनट लग सकते हैं, इसलिए यह API एक मज़बूत ’सबमिट और पोल’ (Submit & Poll) आर्किटेक्चर का इस्तेमाल करता है। आप पहले फ़ाइल सबमिट करके job_id पाते हैं, और फिर ट्रांसक्रिप्शन पूरा होने तक स्टेटस एंडपॉइंट को पोल करते हैं।

1. ऑडियो जॉब सबमिट करें

पोस्ट /api/v1/stt/submit/
पैरामीटर आवश्यक टाइप विवरण
audio ज़रूरी फ़ाइल ट्रांसक्राइब करने के लिए ऑडियो फ़ाइल। mp3, wav, m4a आदि फ़ॉर्मैट सपोर्ट करती है। ज़्यादा से ज़्यादा 50MB।
language वैकल्पिक डोरी डिफ़ॉल्ट ar-JO है।
output_format वैकल्पिक डोरी json या srt स्वीकार करता है। डिफ़ॉल्ट json है।

2. जॉब का स्टेटस देखें

प्राप्त करें /api/v1/stt/status/{job_id}/

प्रोडक्शन इंटीग्रेशन का उदाहरण (Python)

import requests
import time

API_KEY = "YOUR_API_KEY"
HEADERS = {"Authorization": f"Bearer {API_KEY}"}

# 1. ऑडियो फ़ाइल सबमिट करें
submit_url = "https://moknah.io/api/v1/stt/submit/"
files = {"audio": ("audio.mp3", open("long_audio.mp3", "rb"), "audio/mpeg")}
data = {"language": "ar-JO", "output_format": "json"}

print("ऑडियो सबमिट किया जा रहा है...")
response = requests.post(submit_url, headers=HEADERS, files=files, data=data)
job_id = response.json().get("job_id")
print(f"जॉब कतार में लग गई! ID: {job_id}")

# 2. नतीजे के लिए पोल
status_url = f"https://moknah.io/api/v1/stt/status/{job_id}/"

while True:
    res = requests.get(status_url, headers=HEADERS)
    result = res.json()

    if result.get("status") in ["queued", "processing"]:
        print("प्रोसेसिंग... 5 सेकंड में फिर से चेक किया जा रहा है।")
        time.sleep(5)
    elif result.get("status") == "completed":
        print("ट्रांसक्रिप्शन पूरा हो गया!")
        print(result["result"]["subtitles"])
        break
    else:
        print("\nकाम पूरा नहीं हो सका:", result)
        break
API सपोर्ट

API से जुड़े सवालों या समस्याओं के लिए, हमसे संपर्क करें api@moknah.io.