Премини към основното съдържание
Български— Изберете език
Меню

Поточно предаване чрез SSE

Урок 13 от 16 Обновен 30 юли 2026 г. Програмист
На тази страница
  1. Отговори в реално време
  2. Активиране на поточно предаване
  3. Типове събития
  4. Поточно предаване в Python
  5. Поточно предаване с инструменти
  6. Интеграция във фронтенда
  7. Поточно предаване и таксуване
  8. Ключови изводи

Отговори в реално време

В нормален режим чакате моделът да завърши генерирането на целия отговор, преди да го получите. При поточното предаване чрез SSE (Server-Sent Events), токените пристигат в момента на тяхното генериране. Това е от съществено значение за разговорните интерфейси, където потребителите искат да виждат отговора, появяващ се постепенно.

SSE
Server-Sent Events
~50ms
Първият токен става видим
text/event-stream
Content-Type
stream: true
Единствен параметър

Активиране на поточно предаване

Добавете "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
  }'

Отговорът пристига като 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": {...}}

Типове събития

СъбитиеОписание
response.createdСтартиране на генерирането
response.output_item.addedНов елемент в изхода
response.content_part.addedНова част от съдържанието
response.output_text.deltaТекстов фрагмент (най-често срещан)
response.output_text.doneПълен текст на елемент
response.completedОтговорът е финализиран с информация за използването
response.failedГрешка по време на генерирането

Поточно предаване в 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 принуждава незабавното показване на всеки фрагмент.

Поточно предаване с инструменти

Когато моделът използва инструменти в режим на поточно предаване, получавате допълнителни събития:

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

За клиентски извиквания на функции получавате аргументите постепенно:

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

Интеграция във фронтенда

За уеб приложение изпратете SSE потока към браузъра чрез сървърна крайна точка:

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

Поточно предаване и таксуване

Поточното предаване не променя таксуването. Цената е идентична, независимо дали е активирано или не – различава се само режимът на доставка. Пълният обект usage е наличен в събитието response.completed.

Ключови изводи

  • stream: true активира поточното предаване чрез SSE – токените пристигат в момента на генерирането им
  • Събитието response.output_text.delta съдържа всеки текстов фрагмент
  • Събитието response.completed съдържа крайния отговор с метаданни за използването
  • Поточното предаване работи с инструменти (web_search, функции)
  • Цената е еднаква със или без поточно предаване