Miért a Responses API?
Ezen az oldalon
Új végpont új ambíciókhoz
A Responses API az xAI új elsődleges végpontja a Grok modellekkel való kommunikációhoz. Ha már ismered a Chat Completions végpontot (amely kompatibilis az OpenAI-val), valószínűleg azon tűnődsz, miért hozott létre az xAI egy második végpontot. A válasz egyetlen szóban összefoglalható: fejlődés.
A Chat Completions továbbra is elérhető az OpenAI SDK-kkal való visszafelé kompatibilitás érdekében, de az xAI minden új platformfunkciót először a Responses API-ban vezet be. Ez az a végpont, amelybe érdemes befektetned a tanulási idődet.
Állapotkezelés vs. állapot nélküli működés: az alapvető változás
A két végpont közötti legfontosabb különbség a beszélgetési állapot kezelésének módja.
Chat Completions (állapot nélküli)
A Chat Completions esetén minden kérés független. Minden híváshoz el kell küldened a teljes beszélgetés előzményeit:
{
"model": "grok-4.20-0309-reasoning",
"messages": [
{"role": "system", "content": "You are an assistant."},
{"role": "user", "content": "Hello"},
{"role": "assistant", "content": "Hello! How can I help you?"},
{"role": "user", "content": "Tell me about AI."}
]
}
Minél hosszabb a beszélgetés, annál nagyobb a kérés. Neked kell kezelned a kontextust.
Responses API (állapotkezelő)
A Responses API esetén az xAI szervere őrzi az előzményeket. Csak az új üzenetedet és az előző válaszra való hivatkozást kell elküldened:
{
"model": "grok-4.20-0309-reasoning",
"input": "Tell me about AI.",
"previous_response_id": "resp-abc123"
}
A szerver újraépíti neked a teljes kontextust. Kevesebb adatot kell továbbítanod, kevesebb kódot kell írnod, és kevesebb hiba lehetséges.
Kizárólagos funkciók
Számos funkció kizárólag a Responses API-n keresztül érhető el:
- Natív szervereszközök: a
web_search,x_searchés acode_interpreterközvetlenül az xAI szerverein fut, bármilyen további konfiguráció nélkül a részedről - Beszélgetések láncolása: a
previous_response_idsegítségével a modell megőrzi az összes kontextust anélkül, hogy újra el kellene küldened azt - Tartós tárolás: a
store: truebeállítással a válaszaid 30 napig megőrződnek, és GET kéréssel lekérhetők - Titkosított következtetés: a legújabb Grok modellek belső következtetési folyamatát titkosított formában kérheted le, hogy későbbi kérésekben újra felhasználd
- Részletes költségkövetés: minden válasz tartalmazza a
cost_in_nano_usdmezőt, így pontosan kontrollálhatod a kiadásaidat
Mikor melyik végpontot használd?
A Chat Completions végpontot csak akkor használd, ha egy meglévő projektet migrálsz az OpenAI API-ról, és nem tudod azonnal módosítani a kódodat.
Bármilyen új projekt esetén a Responses API-t használd. Egyszerűbb, erősebb, és ez fogja megkapni az xAI platform jövőbeli fejlesztéseit.
Főbb megállapítások
- A Responses API az xAI elsődleges végpontja – a Chat Completions elavult
- Állapotkezelő: a szerver kezeli a beszélgetés előzményeit
- Natív szervereszközöket kínál (webes keresés, X, kódértelmező)
- A tartós tárolás lehetővé teszi, hogy akár 30 nap múlva is folytathasd a beszélgetéseket
- Minden új projektnek a Responses API-t kellene használnia