> This is a page from the ElevenLabs documentation. For a complete page index, fetch https://elevenlabs.io/docs/llms.txt. For the full documentation in a single file, fetch https://elevenlabs.io/docs/llms-full.txt.

# Riferimento degli eventi in tempo reale

> **Note**
>
> **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](/docs/it/api-reference/speech-to-text/v-1-speech-to-text-realtime) 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](/docs/it/eleven-api/guides/how-to/speech-to-text/realtime/transcripts-and-commit-strategies#keeping-the-connection-alive-during-silence) — `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                                                            |