Moknah Documenti
Inizia gratis
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.