Riferimento API
Trascrizione da voce a testo (STT)
Carica file audio preregistrati per ottenere trascrizioni testuali accurate con timestamp in modo asincrono.
Poiché l'elaborazione di file audio di grandi dimensioni può richiedere diversi minuti, questa API utilizza una solida architettura Submit & Poll (invio e verifica). Prima invii il file per ricevere un job_id, poi interroghi l'endpoint di stato finché la trascrizione non è completata.
1. Invia processo audio
POST
/api/v1/stt/submit/
| Parametro | Obbligatorio | Tipo | Descrizione |
|---|---|---|---|
| audio | obbligatorio | file | Il file audio da trascrivere. Supporta mp3, wav, m4a, ecc. Max 50 MB. |
| language | opzionale | string | Il valore predefinito è ar-JO. |
| output_format | opzionale | string | Accetta json o srt. Il valore predefinito è json. |
2. Controlla lo stato del processo
GET
/api/v1/stt/status/{job_id}/
Esempio di integrazione in produzione (Python)
import requests
import time
API_KEY = "YOUR_API_KEY"
HEADERS = {"Authorization": f"Bearer {API_KEY}"}
# 1. Invia il file 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("Invio dell'audio in corso...")
response = requests.post(submit_url, headers=HEADERS, files=files, data=data)
job_id = response.json().get("job_id")
print(f"Processo in coda! ID: {job_id}")
# 2. Interroga per il risultato
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("Elaborazione in corso... nuovo controllo tra 5 secondi.")
time.sleep(5)
elif result.get("status") == "completed":
print("\nTrascrizione completata!")
print(result["result"]["subtitles"])
break
else:
print("\nProcesso fallito:", result)
break
Supporto API
Per domande o problemi relativi all'API, contattaci all'indirizzo api@moknah.io.