Örökölt státusz és az állapotmentes elv
Ezen az oldalon
Frissítve: 2026. november 3. az xAI legjobb gyakorlatai alapján: az xAI mostantól elavultnak (deprecated) minősíti a Chat Completions végpontot, és a Responses API használatát javasolja a Grok következtető modellekhez. A konkrét ok: a Chat Completions nem tartalmaz mezőt a modell titkosított következtetési folyamatához, így minden többmenetes beszélgetés vagy eszközhívás esetén elvesznek az előző menetek következtetései. Az új funkciók is először a Responses API-n jelennek meg. Források: xAI Best Practices · Chat Completions (legacy).
A Chat Completions végpont az xAI ökoszisztémában
Az xAI API két fő végpontot kínál a Grok modellekkel való kommunikációhoz: a Responses API-t (elsődleges végpont) és a Chat Completions végpontot. Ez utóbbit örökölt (legacy) státuszúként jelölték meg: továbbra is teljes mértékben működőképes, de az új funkciók fejlesztése és bevezetése immár a Responses API-t prioritásként kezeli.
Miért érdemes mégis foglalkozni vele? Mert a Chat Completions marad az ökoszisztéma legszélesebb körben használt végpontja. Minden meglévő OpenAI SDK, olyan keretrendszerek, mint a LangChain vagy a LlamaIndex, valamint ezernyi oktatóanyag ezt a formátumot használja. Ha másik szolgáltatóról migrálsz, vagy harmadik féltől származó eszközökkel dolgozol, nagy valószínűséggel ezzel a végponttal fogsz először találkozni.
Állapotmentes végpont: Minden kéréssel küldd el az egészet
A Chat Completions alapelve az állapotmentesség (stateless): a szerver nem tárol beszélgetési előzményeket. Minden hívásnál neked kell mellékelned a korábbi üzenetek teljes történetét a kérésedben.
Konkrétabban ez azt jelenti, hogy egy 10 váltásból álló beszélgetés esetén a 11. kérésednek tartalmaznia kell az előző 10 üzenetet (felhasználó + asszisztens) plusz az új üzenetet. Az alkalmazásod kezeli ezt az előzményt.
{
"model": "grok-4.20-0309-reasoning",
"messages": [
{"role": "system", "content": "You are a helpful assistant."},
{"role": "user", "content": "Hello!"},
{"role": "assistant", "content": "Hello! How can I help you?"},
{"role": "user", "content": "Explain deep learning to me."}
]
}
Ebben a példában az első három üzenet a beszélgetés előzményeit képviseli. Csak az utolsó az új felhasználói üzenet. A modellnek szüksége van erre a teljes kontextusra, hogy koherens választ tudjon generálni.
Gyakorlati következmények
Ennek az állapotmentes megközelítésnek több fontos következménye van:
- Teljes kontroll: te döntöd el pontosan, mely üzenetek kerülnek a modellhez. Szűrhetsz, összefoglalhatsz vagy módosíthatsz az előzményeken minden hívás előtt.
- Arányos költség: minden kérés után az elküldött összes tokent számlázzák, beleértve az előzményeket is. Minél hosszabb a beszélgetés, annál többe kerül minden egyes váltás.
- Nincs szerveroldali tárolás: a kérések között semmilyen adat nem marad tárolva az xAI oldalán. Ez az adatvédelem szempontjából előny, de azt jelenti, hogy neked kell megoldanod az adatok tartós tárolását.
Összehasonlítás a Responses API-val
Ezzel szemben a Responses API állapotfüggő (stateful): a previous_response_id segítségével szerveroldalon tartja nyilván az előzményeket. Nem kell újra elküldened a korábbi üzeneteket – egy egyszerű azonosító is elég. A válaszok legfeljebb 30 napig tárolhatók a store: true paraméterrel.
A kettő közötti választás a használati esetedtől függ. Ha meglévő OpenAI SDK-val dolgozol, vagy másik szolgáltatóról migrálsz, a Chat Completions a logikus kiindulópont. Új projekt esetén azonban a Responses API használata javasolt.
Főbb megállapítások
- A Chat Completions örökölt státuszú, de továbbra is teljes mértékben működőképes és kompatibilis az OpenAI ökoszisztémával
- A végpont állapotmentes: minden kéréssel újra el kell küldened a teljes előzményt
- Minden kérés költsége magában foglalja az összes előzmény-token díját
- A Responses API állapotfüggő alternatívát kínál szerveroldali tárolással
- Következtető modellek esetén 3600 másodperces időtúllépés (timeout) javasolt