Vai al contenuto principale
Italiano— Scegli una lingua
Menu

Streaming SSE

Lezione 13 di 16 Aggiornata il 30 luglio 2026 Sviluppatore
In questa pagina
  1. Risposte in tempo reale
  2. Abilitare lo streaming
  3. Tipi di evento
  4. Streaming in Python
  5. Streaming con gli strumenti
  6. Integrazione frontend
  7. Streaming e fatturazione
  8. Punti chiave

Risposte in tempo reale

In modalità normale, attendi che il modello finisca di generare l’intera risposta prima di riceverla. Con lo streaming SSE (Server-Sent Events), i token arrivano man mano che vengono generati. Questo è essenziale per le interfacce conversazionali in cui gli utenti vogliono vedere la risposta apparire progressivamente.

SSE
Server-Sent Events
~50ms
Primo token visibile
text/event-stream
Content-Type
stream: true
Singolo parametro

Abilitare lo streaming

Aggiungi "stream": true alla tua richiesta:

curl https://api.x.ai/v1/responses \
  -H "Authorization: Bearer $XAI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-4.20-0309-reasoning",
    "input": "Write a poem about programming.",
    "stream": true
  }'

La risposta arriva come stream SSE:

data: {"type": "response.created", "response": {...}}
data: {"type": "response.output_item.added", ...}
data: {"type": "response.content_part.added", ...}
data: {"type": "response.output_text.delta", "delta": "La "}
data: {"type": "response.output_text.delta", "delta": "programmation "}
data: {"type": "response.output_text.delta", "delta": "est "}
...
data: {"type": "response.completed", "response": {...}}

Tipi di evento

EventoDescrizione
response.createdInizio della generazione
response.output_item.addedNuovo elemento nell’output
response.content_part.addedNuova parte di contenuto
response.output_text.deltaFrammento di testo (il più frequente)
response.output_text.doneTesto completo di un elemento
response.completedRisposta finalizzata con i dati di utilizzo
response.failedErrore durante la generazione

Streaming in Python

stream = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="Explain how a compiler works.",
    stream=True
)

full_text = ""
for event in stream:
    if event.type == "response.output_text.delta":
        print(event.delta, end="", flush=True)
        full_text += event.delta
    elif event.type == "response.completed":
        usage = event.response.usage
        print(f"\n\nTokens: {usage.total_tokens}")
        print(f"Cost: {usage.cost_in_nano_usd / 1e9:.6f} USD")

flush=True forza la visualizzazione immediata di ogni frammento.

Streaming con gli strumenti

Quando il modello utilizza gli strumenti in modalità streaming, ricevi eventi aggiuntivi:

data: {"type": "response.output_item.added", "item": {"type": "web_search_call"}}
data: {"type": "response.web_search_call.in_progress", ...}
data: {"type": "response.web_search_call.completed", ...}
data: {"type": "response.output_text.delta", "delta": "Selon les résultats..."}

Per le chiamate di funzione lato client, ricevi gli argomenti progressivamente:

data: {"type": "response.function_call.arguments.delta", "delta": "{\"city\""}
data: {"type": "response.function_call.arguments.delta", "delta": ": \"Paris\"}"}
data: {"type": "response.function_call.arguments.done", ...}

Integrazione frontend

Per un’applicazione web, invia lo stream SSE al browser tramite un endpoint server:

const response = await fetch('/api/chat', {
  method: 'POST',
  body: JSON.stringify({ message: userInput })
});

const reader = response.body.getReader();
const decoder = new TextDecoder();

while (true) {
  const { done, value } = await reader.read();
  if (done) break;
  const text = decoder.decode(value);
  outputElement.textContent += text;
}

Streaming e fatturazione

Lo streaming non modifica la fatturazione. Il costo è identico che sia abilitato o meno: cambia solo la modalità di consegna. L’oggetto usage completo è disponibile nell’evento response.completed.

Punti chiave

  • stream: true abilita lo streaming SSE: i token arrivano man mano che vengono generati
  • L’evento response.output_text.delta contiene ogni frammento di testo
  • L’evento response.completed contiene la risposta finale con i metadati di utilizzo
  • Lo streaming funziona con gli strumenti (web_search, funzioni)
  • Il costo è identico con o senza streaming