Moknah Docs
Gratis starten
API-referentie

Spraak-naar-tekst (STT) transcriptie

Upload vooraf opgenomen audiobestanden om asynchroon nauwkeurige teksttranscripties met tijdstempels te ontvangen.

Omdat het verwerken van grote audiobestanden enkele minuten kan duren, gebruikt deze API een robuuste 'Submit & Poll'-architectuur. Je dient eerst het bestand in om een job_id te ontvangen en vraagt vervolgens de status-endpoint op totdat de transcriptie is voltooid.

1. Audiotaak indienen

POST /api/v1/stt/submit/
Parameter Verplicht Type Beschrijving
audio verplicht file Het te transcriberen audiobestand. Ondersteunt mp3, wav, m4a, enz. Max. 50 MB.
language optioneel string Standaard is ar-JO.
output_format optioneel string Accepteert json of srt. Standaard is json.

2. Taakstatus controleren

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

Voorbeeld van productie-integratie (Python)

import requests
import time

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

# 1. Het audiobestand indienen
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 indienen...")
response = requests.post(submit_url, headers=HEADERS, files=files, data=data)
job_id = response.json().get("job_id")
print(f"Taak in wachtrij! ID: {job_id}")

# 2. Het resultaat opvragen
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("Verwerken... over 5 seconden opnieuw controleren.")
        time.sleep(5)
    elif result.get("status") == "completed":
        print("\nTranscriptie voltooid!")
        print(result["result"]["subtitles"])
        break
    else:
        print("\nTaak mislukt:", result)
        break
API-ondersteuning

Voor vragen of problemen met betrekking tot de API kun je contact met ons opnemen via api@moknah.io.