---
title: "Cosa sono i server-sent events (SSE)? Il formato spiegato"
description: "I server-sent events (SSE) sono il formato text/event-stream dello streaming delle API LLM. Come funzionano righe data, riga vuota, riconnessione e [DONE]."
url: https://broadrouter.com/it/glossary/sse/
lang: it
updated: 2026-11-14
publisher: BroadRouter (a BroadNet site); API by BroadNet Inference, https://inference.broadnet.ai
---

Tradotto dall’inglese con l’aiuto dell’IA. [Leggi l’originale in inglese](https://broadrouter.com/glossary/sse/) (aggiornato il 2026-11-14).

# Server-sent events (SSE)

Aggiornato 2026-11-14

I server-sent events (SSE) sono uno standard web con cui un server invia a un client un flusso di eventi testuali su un’unica risposta HTTP di lunga durata, con content type text/event-stream. Ogni evento è composto da una o più righe di campo, come data:, ed è chiuso da una riga vuota.

Detto anche: SSE, server-sent events, eventi inviati dal server, streaming SSE, text/event-stream, event stream, EventSource

SSE è l’impaginazione in testo semplice che sta sotto quasi ogni risposta LLM in streaming. Conoscere il formato aiuta quando non hai un SDK o quando uno stream si comporta in modo strano.

## Come funziona

Il formato è definito dallo standard HTML del WHATWG. La risposta ha tipo MIME `text/event-stream` ed è sempre in UTF-8. Il body è fatto di righe `campo: valore`:

```text
: keep-alive comment, ignored by clients

event: update
id: 42
data: first line
data: second line

data: {"choices":[{"delta":{"content":"Hi"}}]}

data: [DONE]
```

Le regole di parsing che contano:

-   **Una riga vuota invia l’evento.** Finché non arriva, il client tiene tutto in buffer.
-   **Più righe `data:` si uniscono con un a capo** in un unico messaggio.
-   **Una riga che inizia con i due punti è un commento.** I server li inviano per tenere aperte le connessioni inattive.
-   **Uno spazio dopo i due punti viene rimosso.** Le righe possono terminare con CRLF, LF o CR.
-   **`event`, `id` e `retry`** impostano il tipo di evento, l’ID dell’ultimo evento e il ritardo di riconnessione in millisecondi.

Le letture dalla rete non coincidono con gli eventi. Una lettura può contenere mezzo evento o tre eventi, quindi un parser deve accumulare i byte e dividere sulle righe vuote, non sulle letture.

## Riconnessione, proxy e \[DONE\]

Lo standard prevede un meccanismo di recupero per i browser: dopo un’interruzione, `EventSource` si riconnette e invia un header `Last-Event-ID`, e un server può fermare i tentativi con HTTP 204. La specifica avverte anche che i “legacy proxy servers” (proxy server legacy) possono chiudere le connessioni HTTP dopo un breve timeout, e suggerisce una riga di commento “every 15 seconds or so” (ogni 15 secondi circa).

Le API LLM usano meno di tutto questo. Lo stream di Chat Completions di OpenAI invia solo righe `data:` e termina con `data: [DONE]`, una convenzione dell’API, non di SSE. Non c’è un ID evento da cui ripartire, quindi uno stream interrotto non si può continuare; un nuovo tentativo è una nuova richiesta. Il quadro generale dello [streaming](https://broadrouter.com/it/glossary/streaming/) e il vantaggio sul time to first token sono trattati in quella pagina.

## Su BroadNet Inference

La documentazione di BroadNet dice di impostare `stream=true` e di “read Server-Sent Events until the literal `data: [DONE]` marker” (traduzione: leggere i Server-Sent Events fino al marcatore letterale `data: [DONE]`). Se la connessione si chiude prima, considera la risposta incompleta, registra l’header `X-Request-ID` e decidi se una nuova richiesta di inferenza è sicura. Con `stream_options: {"include_usage": true}`, l’usage arriva nell’ultimo chunk. L’esempio curl della documentazione usa `-N` perché curl non faccia buffering. Uno stream occupa anche uno slot di [concorrenza](https://broadrouter.com/it/glossary/concurrency/) finché non finisce: 4 con una chiave a consumo, uno con una chiave oraria. La documentazione chiede di verificare lo streaming modello per modello prima della produzione. Il codice per ogni SDK è nella [guida allo streaming](https://broadrouter.com/it/guides/streaming-chat-completions/), e il contenuto dei chunk è spiegato in [Lo streaming LLM spiegato](https://broadrouter.com/it/blog/llm-streaming-sse-explained/).

## Domande frequenti

### Posso usare l’API EventSource del browser con un’API LLM?

Di solito non direttamente. Il costruttore EventSource della specifica accetta solo un URL e un flag withCredentials, quindi non può inviare un body POST né un header Authorization. Usa fetch e fai tu il parsing dello stream, oppure un SDK.

### Cosa significa "data: \[DONE\]"?

Non fa parte dello standard SSE. Le API in stile OpenAI inviano la riga letterale "data: \[DONE\]" come ultimo evento per dire che la risposta è completa.

### Perché il mio stream arriva tutto in una volta?

Qualcosa tra il server e il tuo codice sta mettendo in buffer la risposta, per esempio un reverse proxy, un framework o curl senza -N. Disattiva il buffering per quella rotta.

## Vedi anche

-   [Streaming](https://broadrouter.com/it/glossary/streaming/) (termine)
-   [Time to first token (TTFT)](https://broadrouter.com/it/glossary/time-to-first-token/) (termine)
-   [Concorrenza (concurrency)](https://broadrouter.com/it/glossary/concurrency/) (termine)
-   [API compatibile con OpenAI](https://broadrouter.com/it/glossary/openai-compatible-api/) (termine)
-   [Chiave di idempotenza (idempotency key)](https://broadrouter.com/it/glossary/idempotency-key/) (termine)
-   [Streaming delle chat completions e connessioni interrotte](https://broadrouter.com/it/guides/streaming-chat-completions/) (guida)
-   [Codici di errore di BroadNet Inference e quando ritentare](https://broadrouter.com/it/guides/errors-and-retries/) (guida)
-   [Streaming degli LLM spiegato: chunk SSE, delta, usage e annullamento](https://broadrouter.com/it/blog/llm-streaming-sse-explained/) (articolo)

Provalo sul tuo carico di lavoro reale. I nuovi account partono con USD 5 di credito per Gemma e trascrizione. DeepSeek, GLM e Qwen3.8 richiedono una ricarica.

[Inizia](https://inference.broadnet.ai/account/?utm_source=broadrouter&utm_medium=referral&utm_campaign=it-glossary-sse&utm_content=page-cta) ·

**Fonti**

-   [WHATWG HTML Living Standard, server-sent events](https://html.spec.whatwg.org/multipage/server-sent-events.html)
-   [Riferimento API di OpenAI, creare una chat completion (stream, data \[DONE\])](https://developers.openai.com/api/reference/resources/chat/subresources/completions/methods/create)
-   [Riferimento API di BroadNet Inference, testo in streaming (in inglese)](https://inference.broadnet.ai/docs?utm_source=broadrouter&utm_medium=referral&utm_campaign=it-glossary-sse&utm_content=sources#requests)
