Riferimento degli eventi in tempo reale | ElevenLabs Documentation

Riferimento · Elenca tutti gli eventi inviati e ricevuti tramite l’API WebSocket Trascrizione vocale in tempo reale.

Consulta il riferimento API dell’API Trascrizione vocale in tempo reale per maggiori informazioni sull’API e sulle sue opzioni.

committed_transcript è l’evento finale e stabile per ogni segmento. L’API pubblica non emette un evento final_transcript separato.

Eventi inviati

Evento	Descrizione	Quando usarlo
`input_audio_chunk`	Invia dati audio per la trascrizione	Continuamente durante lo streaming audio

Eventi ricevuti

Evento	Descrizione	Quando viene ricevuto
`session_started`	Conferma la connessione e restituisce la configurazione della sessione	Subito dopo aver stabilito la connessione WebSocket
`partial_transcript`	Aggiornamento della trascrizione in tempo reale per il segmento in corso. Le parti successive sostituiscono quelle precedenti. Viene inviato anche come keepalive — `text` vuoto se il segmento non ha testo non confermato, oppure una ripetizione dell’ultima parte se presente	Durante l’elaborazione audio, prima di un commit. Viene inviato anche come keepalive circa una volta ogni `keepalive_interval_ms`, se configurato
`committed_transcript`	Trascrizione consolidata di un segmento. È il testo finale e stabile del segmento e non cambierà	Dopo un commit (manuale o attivato dal VAD)
`committed_transcript_with_timestamps`	Trascrizione confermata con timestamp a livello di parola e `language_code` rilevato	Inviato dopo la trascrizione confermata. Viene ricevuto solo quando nei parametri query è incluso `include_timestamps=true` o `include_language_detection=true`
`committed_transcript_entities`	Entità rilevate nel segmento della trascrizione confermata, con offset dei caratteri	Inviato poco dopo ogni trascrizione confermata. Viene ricevuto solo quando nei parametri query è incluso `entity_detection`
`edited_transcript`	Versione modificata del segmento della trascrizione confermata, insieme al testo originale confermato	Inviato poco dopo ogni trascrizione confermata. Viene ricevuto solo quando nei parametri query è incluso `transcript_edit`

Gestione degli errori

Se si verifica un errore, viene restituito un messaggio di errore prima della chiusura della connessione WebSocket.

Tipo di errore	Descrizione
`auth_error`	Si è verificato un errore durante l’autenticazione della richiesta. Ricontrolla la tua chiave API
`quota_exceeded`	Hai superato la tua quota di utilizzo
`transcriber_error`	Si è verificato un errore durante la trascrizione dell’audio.
`input_error`	Si è verificato un errore durante l’elaborazione del chunk audio. Probabilmente a causa di formato di input o parametri non validi
`invalid_request`	I parametri di connessione sono stati rifiutati. Controlla i parametri query nel riferimento API
`error`	Errore generico del server
`commit_throttled`	Il commit è stato limitato a causa di troppe richieste di commit effettuate in un breve periodo
`unaccepted_terms`	Non hai accettato i termini di servizio per usare Scribe. Consulta e accetta termini e condizioni nella dashboard di ElevenLabs
`rate_limited`	Hai raggiunto un limite di frequenza. Riduci il numero di richieste effettuate in un breve periodo
`queue_overflow`	La coda di elaborazione è piena. Invia meno richieste in un breve periodo
`resource_exhausted`	Le risorse del server sono esaurite. Riprova più tardi
`session_time_limit_exceeded`	È stato raggiunto il tempo massimo della sessione. Avvia una nuova sessione o aggiorna il tuo abbonamento
`chunk_size_exceeded`	La dimensione del chunk audio è troppo grande. Riduci la dimensione del chunk
`insufficient_audio_activity`	Non hai inviato attività audio sufficiente per mantenere la connessione