Konuşmadan Metne (STT) Döküm

Zaman damgalı ve doğru metin dökümü elde etmek için önceden kaydedilmiş ses dosyalarını asenkron olarak yükleyin.

Büyük ses dosyalarının işlenmesi birkaç dakika sürebileceğinden, bu API sağlam bir ”Gönder ve Sorgula” (Submit & Poll) mimarisi kullanır. Öncelikle bir `job_id` almak için dosyayı gönderir, ardından döküm işlemi tamamlanana kadar durum uç noktasını (status endpoint) sorgularsınız.

1. Ses İşini Gönder

GÖNDERİ /api/v1/stt/submit/

Parametre	Gerekli	Tür	Açıklama
audio	gerekli	dosya	Metne dönüştürülecek ses dosyası. mp3, wav, m4a vb. formatları destekler. Maks. 50 MB.
language	isteğe bağlı	ip	Varsayılan ar-JO’dur.
output_format	isteğe bağlı	ip	json veya srt kabul eder. Varsayılan json’dır.

2. İş Durumunu Kontrol Et

AL /api/v1/stt/status/{job_id}/

Örnek Canlı Ortam Entegrasyonu (Python)

import requests
import time

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

# 1. Ses dosyasını gönderin
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("Ses gönderiliyor...")
response = requests.post(submit_url, headers=HEADERS, files=files, data=data)
job_id = response.json().get("job_id")
print(f"İş kuyruğa alındı! Kimlik: {job_id}")

# 2. Sonucu sorgula
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("İşleniyor... 5 saniye içinde tekrar kontrol ediliyor.")
        time.sleep(5)
    elif result.get("status") == "completed":
        print("\nTranskripsiyon tamamlandı!")
        print(result["result"]["subtitles"])
        break
    else:
        print("\nİş Başarısız Oldu:", result)
        break

API Desteği

API ile ilgili soru veya sorunlarınız için bizimle şu adresten iletişime geçin: api@moknah.io.