Chat Completions vs Responses API: Porovnanie
Na tejto strane
Dva koncové body, dve filozofie
xAI ponúka dva koncové body na interakciu s modelmi Grok: Chat Completions (/v1/chat/completions) a Responses API (/v1/responses). Pochopenie ich rozdielov je kľúčové pre výber správneho koncového bodu pre tvoj projekt a plánovanie prípadnej migrácie.
| Aspekt | Chat Completions | API Responses |
|---|---|---|
| Stav | Legacy (zastarané) | Primárne (odporúčané) |
| Správa stavu | Bezstavová (odosielanie histórie) | So stavom (previous_response_id) |
| Ukladanie na serveri | Nie | Áno (30 dní pri store: true) |
| Konverzácia | Pole správ | Reťazené podľa ID |
| Nástroje servera | Iba volanie funkcií | web_search, x_search, code_interpreter, functions |
| Šifrované uvažovanie | Nie | Áno (encrypted_content) |
| Nové funkcie | Nie sú prioritou | Prioritné |
| Kompatibilita s OpenAI | Úplná | Čiastočná |
Správa stavu: zásadný rozdiel
Chat Completions: históriu spravuješ ty
Pri každej požiadavke musíš odoslať celú konverzáciu nanovo:
# Chat Completions — zakaždým odoslať všetko
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: históriu spravuje server
Pri Responses API stačí na pokračovanie konverzácie jednoduchý identifikátor:
# Responses API — stačí ID predchádzajúcej odpovede
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 si uchováva kontext a automaticky rekonštruuje históriu. Neplatíš menej tokenov (história sa stále účtuje), ale zjednodušuješ si kód a zmenšuješ veľkosť svojich požiadaviek.
Exkluzívne nástroje a funkcie
Responses API poskytuje prístup k serverovým nástrojom, ktoré Chat Completions neponúka:
web_search: vyhľadávanie na webe v reálnom časex_search: vyhľadávanie v príspevkoch na X (Twitter)code_interpreter: vykonávanie kódu Python na strane servera
Tieto nástroje sú priamo integrované do požiadavky:
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 volanie funkcií (nástroje definované vývojárom), ale nie tieto serverové nástroje spravované xAI.
Kedy použiť Chat Completions?
Chat Completions zostáva správnou voľbou v niekoľkých scenároch:
- Migrácia z OpenAI: tvoj existujúci kód funguje bez zásadných úprav
- Viacerí poskytovatelia: chceš prepínať medzi OpenAI, Anthropic a xAI s rovnakým kódom
- Frameworky tretích strán: LangChain, LlamaIndex, Haystack a väčšina frameworkov používa formát Chat Completions
- Plná kontrola: chceš si históriu spravovať sám (zhrnutie, filtrovanie, úpravy)
Kedy použiť Responses API?
Responses API je vhodnejšie pre:
- Nové projekty: od začiatku využívaš najnovšie funkcie
- Serverové nástroje: potrebuješ vyhľadávanie na webe, vykonávanie kódu alebo vyhľadávanie na X
- Dlhé konverzácie: nemusíš pri každej požiadavke odosielať históriu nanovo
- Šifrované uvažovanie: prístup k obsahu uvažovania pre kontinuitu medzi požiadavkami
Kľúčové poznatky
- Chat Completions je bezstavové (históriu spravuješ ty), Responses API je so stavom (spravuje server)
- Responses API ponúka exkluzívne serverové nástroje: web_search, x_search, code_interpreter
- Chat Completions má úplnú kompatibilitu s OpenAI, Responses API je špecifické pre xAI
- Oba koncové body účtujú celú históriu konverzácie
- Použi Chat Completions pre kompatibilitu, Responses API pre nové funkcie