Ir al contenido principal
Español— Elegir un idioma
Menú

Streaming SSE

Lección 13 de 16 Actualizado el 30 de julio de 2026 Desarrollador
En esta página
  1. Respuestas en tiempo real
  2. Activación del streaming
  3. Tipos de eventos
  4. Streaming en Python
  5. Streaming con herramientas
  6. Integración en el frontend
  7. Streaming y facturación
  8. Puntos clave

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.

SSE
Server-Sent Events
~50 ms
Primer token visible
text/event-stream
Content-Type
stream: true
Único parámetro

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

EventoDescripción
response.createdInicio de la generación
response.output_item.addedNuevo elemento en la salida
response.content_part.addedNueva parte de contenido
response.output_text.deltaFragmento de texto (el más frecuente)
response.output_text.doneTexto completo de un elemento
response.completedRespuesta finalizada con uso
response.failedError 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: true activa el streaming SSE: los tokens llegan a medida que se generan
  • El evento response.output_text.delta contiene cada fragmento de texto
  • El evento response.completed contiene 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