Moknah Doku
Kostenlos starten
API-Referenz

Sprache-zu-Text-Transkription (STT)

Laden Sie vorab aufgenommene Audiodateien hoch, um asynchron präzise Texttranskriptionen mit Zeitstempeln zu erhalten.

Da die Verarbeitung großer Audiodateien mehrere Minuten dauern kann, verwendet diese API eine robuste „Submit & Poll“-Architektur. Sie übermitteln zunächst die Datei, um eine job_id zu erhalten, und fragen dann den Status-Endpunkt ab, bis die Transkription abgeschlossen ist.

1. Audio-Auftrag senden

POST /api/v1/stt/submit/
Parameter Erforderlich Typ Beschreibung
audio erforderlich file Die zu transkribierende Audiodatei. Unterstützt mp3, wav, m4a usw. Max. 50 MB.
language optional string Standard ist ar-JO.
output_format optional string Akzeptiert json oder srt. Standard ist json.

2. Auftragsstatus prüfen

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

Beispiel für eine Produktionsintegration (Python)

import requests
import time

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

# 1. Audiodatei senden
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("Audio wird gesendet...")
response = requests.post(submit_url, headers=HEADERS, files=files, data=data)
job_id = response.json().get("job_id")
print(f"Auftrag in Warteschlange! ID: {job_id}")

# 2. Ergebnis abfragen
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("Wird verarbeitet... erneute Prüfung in 5 Sekunden.")
        time.sleep(5)
    elif result.get("status") == "completed":
        print("\nTranskription abgeschlossen!")
        print(result["result"]["subtitles"])
        break
    else:
        print("\nAuftrag fehlgeschlagen:", result)
        break
API-Support

Bei Fragen oder Problemen rund um die API kontaktieren Sie uns unter api@moknah.io.