Spring til hovedindhold
Dansk— Vælg et sprog
Menu

Streaming SSE

Lektion 13 af 16 Opdateret 30. juli 2026 Udvikler
På denne side
  1. Svar i realtid
  2. Aktiver streaming
  3. Begivenhedstyper
  4. Streaming i Python
  5. Streaming med værktøjer
  6. Integration i frontend
  7. Streaming og fakturering
  8. Vigtige pointer

Svar i realtid

I normal tilstand venter du på, at modellen bliver færdig med at generere hele svaret, før du modtager det. Med SSE-streaming (Server-Sent Events) ankommer tokens, efterhånden som de genereres. Dette er afgørende for samtalegrænseflader, hvor brugere ønsker at se svaret dukke op gradvist.

SSE
Server-Sent Events
~50ms
Første token synligt
text/event-stream
Content-Type
stream: true
Enkelt parameter

Aktiver streaming

Tilføj "stream": true til din anmodning:

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

Svaret ankommer som en SSE-strøm:

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

Begivenhedstyper

BegivenhedBeskrivelse
response.createdGenerering starter
response.output_item.addedNyt element i output
response.content_part.addedNyt indholdselement
response.output_text.deltaTekstfragment (hyppigst)
response.output_text.doneKomplet tekst for et element
response.completedSvar finaliseret med forbrugsdata
response.failedFejl under generering

Streaming i 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 tvinger øjeblikkelig visning af hvert fragment.

Streaming med værktøjer

Når modellen bruger værktøjer i streaming-tilstand, modtager du yderligere begivenheder:

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

For klient-funktionskald modtager du argumenterne gradvist:

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

Integration i frontend

Til en webapplikation sender du SSE-strømmen til browseren via et server-endpoint:

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 og fakturering

Streaming ændrer ikke faktureringen. Omkostningerne er identiske, uanset om det er aktiveret eller ej – kun leveringsmåden er forskellig. Det komplette usage-objekt er tilgængeligt i response.completed-begivenheden.

Vigtige pointer

  • stream: true aktiverer SSE-streaming – tokens ankommer, efterhånden som de genereres
  • Begivenheden response.output_text.delta indeholder hvert tekstfragment
  • Begivenheden response.completed indeholder det endelige svar med metadata om forbrug
  • Streaming fungerer med værktøjer (web_search, funktioner)
  • Omkostningerne er identiske med eller uden streaming