स्पीच टू टेक्स्ट (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.