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

Chat Completions vs Responses API: Összehasonlítás

11. lecke 12 közül Frissítve 2026. július 30. Fejlesztő
Ezen az oldalon
  1. Két végpont, két filozófia
  2. Állapotkezelés: az alapvető különbség
  3. Kizárólagos eszközök és funkciók
  4. Mikor használd a Chat Completions-t?
  5. Mikor használd a Responses API-t?
  6. Főbb megállapítások

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és
  • x_search: keresés az X (Twitter) bejegyzései között
  • code_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