Streaming SSE
En esta página
Respuestas en tiempo real
En el modo normal, debes esperar a que el modelo termine de generar la respuesta completa antes de recibirla. Con el streaming SSE (Server-Sent Events), los tokens llegan a medida que se generan. Esto es esencial para las interfaces conversacionales donde los usuarios quieren ver cómo aparece la respuesta progresivamente.
Activación del streaming
Añade "stream": true a tu solicitud:
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 respuesta llega como un flujo 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": {...}}
Tipos de eventos
| Evento | Descripción |
|---|---|
response.created | Inicio de la generación |
response.output_item.added | Nuevo elemento en la salida |
response.content_part.added | Nueva parte de contenido |
response.output_text.delta | Fragmento de texto (el más frecuente) |
response.output_text.done | Texto completo de un elemento |
response.completed | Respuesta finalizada con uso |
response.failed | Error durante la generación |
Streaming en 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"Coste: {usage.cost_in_nano_usd / 1e9:.6f} USD")
flush=True fuerza la visualización inmediata de cada fragmento.
Streaming con herramientas
Cuando el modelo utiliza herramientas en modo streaming, recibes eventos adicionales:
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..."}
Para llamadas a funciones del cliente, recibes los argumentos progresivamente:
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", ...}
Integración en el frontend
Para una aplicación web, envía el flujo SSE al navegador a través de un punto final del servidor:
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 y facturación
El streaming no cambia la facturación. El coste es idéntico tanto si está activado como si no; solo difiere el modo de entrega. El objeto usage completo está disponible en el evento response.completed.
Puntos clave
stream: trueactiva el streaming SSE: los tokens llegan a medida que se generan- El evento
response.output_text.deltacontiene cada fragmento de texto - El evento
response.completedcontiene la respuesta final con los metadatos de uso - El streaming funciona con herramientas (web_search, functions)
- El coste es idéntico con o sin streaming