Preskok na glavno vsebino
Slovenščina— Izberite jezik
Meni

Pretakanje SSE

Lekcija 13 od 16 Posodobljeno 30. julij 2026 Razvijalec
Na tej strani
  1. Odzivi v realnem času
  2. Omogoči pretakanje
  3. Vrste dogodkov
  4. Pretakanje v Pythonu
  5. Pretakanje z orodji
  6. Integracija s spletnim vmesnikom
  7. Pretakanje in obračunavanje
  8. Ključne ugotovitve

Odzivi v realnem času

V običajnem načinu čakaš, da model zaključi generiranje celotnega odgovora, preden ga prejmeš. Pri pretakanju SSE (Server-Sent Events) žetoni prispevajo sproti, ko se generirajo. To je ključno za pogovorne vmesnike, kjer uporabniki želijo odgovor videti postopoma.

SSE
Server-Sent Events
~50ms
Prvi žeton viden
text/event-stream
Content-Type
stream: true
En sam parameter

Omogoči pretakanje

V zahtevo dodaj "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
  }'

Odgovor prispe kot tok 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": {...}}

Vrste dogodkov

DogodekOpis
response.createdZačetek generiranja
response.output_item.addedNov element v izhodu
response.content_part.addedNov del vsebine
response.output_text.deltaFragment besedila (najpogostejši)
response.output_text.doneCelotno besedilo elementa
response.completedOdgovor zaključen z uporabo
response.failedNapaka med generiranjem

Pretakanje v Pythonu

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 prisili takojšnji izpis vsakega fragmenta.

Pretakanje z orodji

Ko model v načinu pretakanja uporablja orodja, prejmeš dodatne dogodke:

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 klicih funkcij na strani odjemalca argumente prejemaš postopoma:

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

Integracija s spletnim vmesnikom

Za spletno aplikacijo pošlji tok SSE v brskalnik prek strežniške končne točke:

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

Pretakanje in obračunavanje

Pretakanje ne spremeni obračunavanja. Strošek je enak, ne glede na to, ali je omogočeno ali ne – razlikuje se le način dostave. Celoten predmet usage je na voljo v dogodku response.completed.

Ključne ugotovitve

  • stream: true omogoči pretakanje SSE – žetoni prispevajo sproti, ko se generirajo
  • Dogodek response.output_text.delta vsebuje vsak fragment besedila
  • Dogodek response.completed vsebuje končni odgovor z metapodatki o uporabi
  • Pretakanje deluje z orodji (web_search, functions)
  • Strošek je enak s pretakanjem ali brez njega