Chat Completions vs Responses API: Srovnání
Na této stránce
Dva koncové body, dvě filozofie
xAI nabízí dva koncové body pro interakci s modely Grok: Chat Completions (/v1/chat/completions) a Responses API (/v1/responses). Pochopení jejich rozdílů je klíčové pro výběr správného koncového bodu pro tvůj projekt a plánování případné migrace.
| Aspekt | Chat Completions | API Responses |
|---|---|---|
| Stav | Zastaralé (Legacy) | Primární (doporučeno) |
| Správa stavu | Bezstavová (odesílání historie) | Se stavem (previous_response_id) |
| Úložiště na serveru | Ne | Ano (30 dní s store: true) |
| Konverzace | Pole zpráv | Řetězeno podle ID |
| Nástroje serveru | Pouze volání funkcí | web_search, x_search, code_interpreter, functions |
| Šifrované uvažování | Ne | Ano (encrypted_content) |
| Nové funkce | Neprioritizováno | Prioritizováno |
| Kompatibilita s OpenAI | Plná | Částečná |
Správa stavu: zásadní rozdíl
Chat Completions: historii spravuješ ty
S každým požadavkem musíš znovu odeslat celou konverzaci:
# Chat Completions — pokaždé znovu odešli vše
response = client.chat.completions.create(
model="grok-4.20-0309-reasoning",
messages=[
{"role": "system", "content": "You are a helpful assistant."},
{"role": "user", "content": "Hello, my name is Alice."},
{"role": "assistant", "content": "Hello Alice! How can I help you?"},
{"role": "user", "content": "What is my first name?"}
]
)
Responses API: historii spravuje server
U Responses API stačí k pokračování v konverzaci jednoduchý identifikátor:
# Responses API — pouze ID předchozí odpovědi
response1 = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Hello, my name is Alice."
)
response2 = client.responses.create(
model="grok-4.20-0309-reasoning",
input="What is my first name?",
previous_response_id=response1.id
)
Server udržuje kontext a automaticky rekonstruuje historii. Neplatíš méně tokenů (historie se stále účtuje), ale zjednodušíš si kód a zmenšíš velikost svých požadavků.
Exkluzivní nástroje a funkce
Responses API poskytuje přístup k nástrojům serveru, které Chat Completions nenabízí:
web_search: vyhledávání na webu v reálném časex_search: vyhledávání v příspěvcích na X (Twitter)code_interpreter: spouštění kódu Pythonu na straně serveru
Tyto nástroje jsou integrovány přímo do požadavku:
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="What is the latest news on AI?",
tools=[{"type": "web_search"}]
)
Chat Completions podporuje volání funkcí (nástroje definované vývojářem), ale ne tyto serverové nástroje spravované xAI.
Kdy použít Chat Completions?
Chat Completions zůstává správnou volbou v několika scénářích:
- Migrace z OpenAI: tvůj stávající kód funguje bez zásadních úprav
- Více poskytovatelů: chceš přepínat mezi OpenAI, Anthropic a xAI se stejným kódem
- Frameworky třetích stran: LangChain, LlamaIndex, Haystack a většina frameworků používá formát Chat Completions
- Plná kontrola: chceš spravovat historii sám (shrnování, filtrování, úpravy)
Kdy použít Responses API?
Responses API je vhodnější pro:
- Nové projekty: využij od začátku nejnovější funkce
- Serverové nástroje: potřebuješ vyhledávání na webu, spouštění kódu nebo vyhledávání na X
- Dlouhé konverzace: není třeba znovu odesílat historii s každým požadavkem
- Šifrované uvažování: přístup k obsahu uvažování pro kontinuitu mezi požadavky
Klíčové poznatky
- Chat Completions je bezstavové (historii spravuješ ty), Responses API je se stavem (spravuje server)
- Responses API nabízí exkluzivní serverové nástroje: web_search, x_search, code_interpreter
- Chat Completions má plnou kompatibilitu s OpenAI, Responses API je specifické pro xAI
- Oba koncové body účtují celou historii konverzace
- Použij Chat Completions pro kompatibilitu, Responses API pro nové funkce