Chat Completions vs Responses API: Összehasonlítás
Ezen az oldalon
Két végpont, két filozófia
Az xAI két végpontot kínál a Grok modellekkel való kommunikációhoz: a Chat Completions (/v1/chat/completions) és a Responses API (/v1/responses). A köztük lévő különbségek megértése elengedhetetlen ahhoz, hogy a projektedhez a megfelelő végpontot válaszd, és esetleges migrációt tervezz.
| Szempont | Chat Completions | Responses API |
|---|---|---|
| Státusz | Örökölt (Legacy) | Elsődleges (ajánlott) |
| Állapotkezelés | Állapot nélküli (előzmények újraküldése) | Állapotalapú (previous_response_id) |
| Szerveroldali tárolás | Nincs | Van (30 napig, ha store: true) |
| Beszélgetés | Üzenettömb | Azonosítóval láncolva |
| Szervereszközök | Csak függvényhívás | web_search, x_search, code_interpreter, functions |
| Titkosított következtetés | Nincs | Van (encrypted_content) |
| Új funkciók | Nem prioritás | Prioritást élveznek |
| OpenAI kompatibilitás | Teljes | Részleges |
Állapotkezelés: az alapvető különbség
Chat Completions: te kezeled az előzményeket
Minden kérésnél újra el kell küldened a teljes beszélgetést:
# Chat Completions — minden alkalommal mindent újraküldeni
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: a szerver kezeli az előzményeket
A Responses API esetén egy egyszerű azonosító is elég a beszélgetés folytatásához:
# Responses API — csak az előző válasz azonosítója
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
)
A szerver megtartja a kontextust, és automatikusan újjáépíti az előzményeket. Nem fizetsz kevesebb tokent (az előzményeket továbbra is számlázzák), de leegyszerűsíted a kódodat, és csökkented a kéréseid méretét.
Kizárólagos eszközök és funkciók
A Responses API hozzáférést biztosít olyan szervereszközökhöz, amelyeket a Chat Completions nem kínál:
web_search: valós idejű webes keresésx_search: keresés az X (Twitter) bejegyzései közöttcode_interpreter: szerveroldali Python kód végrehajtása
Ezek az eszközök közvetlenül integrálva vannak a kérésbe:
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="What is the latest news on AI?",
tools=[{"type": "web_search"}]
)
A Chat Completions támogatja a függvényhívást (fejlesztő által definiált eszközök), de ezeket az xAI által kezelt szervereszközöket nem.
Mikor használd a Chat Completions-t?
A Chat Completions továbbra is a helyes választás több forgatókönyvben is:
- Migráció OpenAI-ról: a meglévő kódod nagyobb módosítások nélkül működik
- Több szolgáltató: ugyanazzal a kóddal szeretnél váltani az OpenAI, az Anthropic és az xAI között
- Harmadik féltől származó keretrendszerek: a LangChain, a LlamaIndex, a Haystack és a legtöbb keretrendszer a Chat Completions formátumot használja
- Teljes kontroll: saját magad szeretnéd kezelni az előzményeket (összefoglalás, szűrés, módosítás)
Mikor használd a Responses API-t?
A Responses API előnyösebb az alábbi esetekben:
- Új projektek:从一开始 élvezd a legújabb funkciókat
- Szervereszközök: szükséged van webes keresésre, kódvégrehajtásra vagy X-keresésre
- Hosszú beszélgetések: nem kell minden kérésnél újraküldeni az előzményeket
- Titkosított következtetés: hozzáférés a következtetési tartalomhoz a kérések közötti folytonosság érdekében
Főbb megállapítások
- A Chat Completions állapot nélküli (te kezeled az előzményeket), a Responses API állapotalapú (a szerver kezeli)
- A Responses API exkluzív szervereszközöket kínál: web_search, x_search, code_interpreter
- A Chat Completions teljes OpenAI kompatibilitással rendelkezik, míg a Responses API specifikus az xAI-ra
- Mindkét végpont a teljes beszélgetési előzményt számlázza
- Használd a Chat Completions-t a kompatibilitás miatt, a Responses API-t pedig az új funkciókért