Ugrás a főtartalomra
Magyar— Nyelv kiválasztása
Menü

Örökölt státusz és az állapotmentes elv

1. lecke 12 közül Frissítve 2026. november 3. Fejlesztő
Ezen az oldalon
  1. A Chat Completions végpont az xAI ökoszisztémában
  2. Állapotmentes végpont: Minden kéréssel küldd el az egészet
  3. Főbb megállapítások

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.

Örökölt
Hivatalos státusz
Állapotmentes
Nincs szerveroldali állapot
OpenAI
Kompatibilis formátum
3600s
Javasolt időtúllépés

Á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