Moknah دستاویزات
مفت شروع کریں
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.