Moknah Documents
Commencez gratuitement
Référence de l’API

Transcription de la parole en texte (STT)

Importez des fichiers audio préenregistrés pour obtenir une transcription textuelle précise et horodatée, de manière asynchrone.

Comme le traitement de fichiers audio volumineux peut prendre plusieurs minutes, cette API repose sur une architecture robuste de type « Submit & Poll » (soumission et interrogation). Vous soumettez d’abord le fichier pour obtenir un `job_id`, puis vous interrogez le point de terminaison d’état jusqu’à ce que la transcription soit terminée.

1. Soumettre une tâche audio

PUBLIER /api/v1/stt/submit/
Paramètre Obligatoire Type Description
audio requis fichier Le fichier audio à transcrire. Formats pris en charge : mp3, wav, m4a, etc. Taille maximale : 50 Mo.
language facultatif chaîne La valeur par défaut est ar-JO.
output_format facultatif chaîne Accepte le format JSON ou SRT. Le format par défaut est JSON.

2. Vérifier le statut de la tâche

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

Exemple d’intégration en production (Python)

import requests
import time

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

# 1. Soumettez le fichier audio
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("Envoi de l’audio...")
response = requests.post(submit_url, headers=HEADERS, files=files, data=data)
job_id = response.json().get("job_id")
print(f"Tâche mise en file d’attente ! ID : {job_id}")

# 2. Interroger pour obtenir le résultat
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("Traitement en cours... nouvelle vérification dans 5 secondes.")
        time.sleep(5)
    elif result.get("status") == "completed":
        print("Transcription terminée !")
        print(result["result"]["subtitles"])
        break
    else:
        print("Échec de la tâche :", result)
        break
Support API

Pour toute question ou tout problème concernant l’API, contactez-nous à l’adresse api@moknah.io.