Поточно предаване чрез SSE
На тази страница
Отговори в реално време
В нормален режим чакате моделът да завърши генерирането на целия отговор, преди да го получите. При поточното предаване чрез SSE (Server-Sent Events), токените пристигат в момента на тяхното генериране. Това е от съществено значение за разговорните интерфейси, където потребителите искат да виждат отговора, появяващ се постепенно.
Активиране на поточно предаване
Добавете "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, функции)
- Цената е еднаква със или без поточно предаване