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.