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.