Prejsť na hlavný obsah
Slovenčina— Vyberte jazyk
Menu

Streamovanie SSE

Lekcia 13 z 16 Aktualizované 30. júla 2026 Vývojár
Na tejto strane
  1. Odpovede v reálnom čase
  2. Aktivácia streamovania
  3. Typy udalostí
  4. Streamovanie v Pythone
  5. Streamovanie s nástrojmi
  6. Integrácia na strane klienta (Frontend)
  7. Streamovanie a fakturácia
  8. Kľúčové poznatky

Odpovede v reálnom čase

V bežnom režime čakáš, kým model dokončí generovanie celej odpovede, až potom ju dostaneš. Pri streamovaní SSE (Server-Sent Events) prichádzajú tokeny priamo počas ich generovania. To je kľúčové pre konverzačné rozhrania, kde používatelia chcú vidieť odpoveď objavujúcu sa postupne.

SSE
Server-Sent Events
~50ms
Prvý token viditeľný
text/event-stream
Content-Type
stream: true
Jediný parameter

Aktivácia streamovania

Do svojej požiadavky pridaj "stream": true:

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
  }'

Odpoveď prichádza ako SSE stream:

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": {...}}

Typy udalostí

UdalosťPopis
response.createdSpustenie generovania
response.output_item.addedPridanie novej položky do výstupu
response.content_part.addedPridanie novej časti obsahu
response.output_text.deltaFragment textu (najčastejšie)
response.output_text.doneKompletný text položky
response.completedOdpoveď finalizovaná vrátane štatistík využitia
response.failedChyba počas generovania

Streamovanie v Pythone

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")

Parameter flush=True vynúti okamžité zobrazenie každého fragmentu.

Streamovanie s nástrojmi

Keď model v režime streamovania používa nástroje, dostávaš ďalšie udalosti:

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..."}

Pri volaniach klientskych funkcií dostávaš argumenty postupne:

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", ...}

Integrácia na strane klienta (Frontend)

Pre webovú aplikáciu pošli SSE stream do prehliadača cez koncový bod servera:

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;
}

Streamovanie a fakturácia

Streamovanie nemení spôsob fakturácie. Náklady sú identické či už je povolené alebo nie – líši sa iba spôsob doručenia. Kompletný objekt usage je dostupný v udalosti response.completed.

Kľúčové poznatky

  • stream: true aktivuje streamovanie SSE – tokeny prichádzajú počas generovania
  • Udalosť response.output_text.delta obsahuje každý textový fragment
  • Udalosť response.completed obsahuje konečnú odpoveď s metadátami o využití
  • Streamovanie funguje s nástrojmi (web_search, funkcie)
  • Náklady sú rovnaké so streamovaním aj bez neho