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.