API ریفرنس
اسپیچ ٹو ٹیکسٹ (STT) ٹرانسکرپشن
ٹائم اسٹیمپس کے ساتھ درست تحریری ٹرانسکرپشن غیر مطابقت پذیر طور پر حاصل کرنے کے لیے پہلے سے ریکارڈ شدہ آڈیو فائلیں اپ لوڈ کریں۔
چونکہ بڑی آڈیو فائلوں کو پروسیس ہونے میں کئی منٹ لگ سکتے ہیں، اس لیے یہ API ایک مضبوط Submit & Poll آرکیٹیکچر استعمال کرتا ہے۔ آپ پہلے فائل جمع کراتے ہیں تاکہ job_id حاصل ہو سکے، اور پھر ٹرانسکرپشن مکمل ہونے تک اسٹیٹس اینڈ پوائنٹ کو چیک کرتے رہتے ہیں۔
1. آڈیو جاب جمع کرائیں
POST
/api/v1/stt/submit/
| پیرامیٹر | لازمی | قسم | تفصیل |
|---|---|---|---|
| audio | لازمی | file | ٹرانسکرائب کرنے کے لیے آڈیو فائل۔ mp3، wav، m4a وغیرہ کو سپورٹ کرتی ہے۔ زیادہ سے زیادہ 50MB۔ |
| language | اختیاری | اسٹرنگ (string) | طے شدہ قدر ar-JO ہے۔ |
| output_format | اختیاری | اسٹرنگ (string) | json یا srt قبول کرتا ہے۔ طے شدہ قدر json ہے۔ |
2. جاب کا اسٹیٹس چیک کریں
GET
/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("\nٹرانسکرپشن مکمل ہو گئی!")
print(result["result"]["subtitles"])
break
else:
print("\nجاب ناکام ہو گئی:", result)
break
API سپورٹ
API سے متعلق سوالات یا مسائل کے لیے، ہم سے یہاں رابطہ کریں api@moknah.io.