Lähe põhisisu juurde
Eesti— Vali keel
Menüü

Chat Completions vs Responses API: võrdlus

Õppetund 11 / 12 Värskendatud 30. juuli 2026 Arendajatele
Sellel lehel
  1. Kaks lõpp-punkti, kaks filosoofiat
  2. Oleku haldamine: fundamentaalne erinevus
  3. Eksklusiivsed tööriistad ja funktsioonid
  4. Millal kasutada Chat Completionsi?
  5. Millal kasutada Responses API-t?
  6. Peamised punktid

Kaks lõpp-punkti, kaks filosoofiat

xAI pakub Groki mudelitega suhtlemiseks kahte lõpp-punkti: Chat Completions (/v1/chat/completions) ja Responses API (/v1/responses). Nende erinevuste mõistmine on hädavajalik, et valida oma projekti jaoks õige lõpp-punkt ja planeerida võimalikku migratsiooni.

Aspekt Chat Completions API Responses
Olek Pärandvara (legacy) Peamine (soovitatav)
Oleku haldamine Olekuvaene (saada ajalugu) Olekuga (previous_response_id)
Serveri salvestusruum Ei Jah (30 päeva väärtusega store: true)
Vestlus Sõnumite massiiv Aheldatud ID järgi
Serveri tööriistad Ainult funktsioonide kutsumine web_search, x_search, code_interpreter, functions
Krüpteeritud arutluskäik Ei Jah (encrypted_content)
Uued funktsioonid Pole prioriteet Prioriteetne
OpenAI ühilduvus Täielik Osaline

Oleku haldamine: fundamentaalne erinevus

Chat Completions: sina haldad ajalugu

Iga päringuga pead saatma kogu vestluse uuesti:

# Chat Completions — saada kõik iga kord uuesti
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: server haldab ajalugu

Responses API puhul piisab vestluse jätkamiseks lihtsast identifikaatorist:

# Responses API — ainult eelmise vastuse ID
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
)

Server hoiab konteksti ja rekonstrueerib ajaloo automaatselt. Sa ei maksa vähem tokenite eest (ajalugu arveldatakse ikka), kuid lihtsustad oma koodi ja vähendad päringute suurust.

Eksklusiivsed tööriistad ja funktsioonid

Responses API annab juurdepääsu serveri tööriistadele, mida Chat Completions ei paku:

  • web_search: reaalajas veebiotsing
  • x_search: otsing X-i (Twitter) postitustes
  • code_interpreter: Pythoni koodi täitmine serveri poolel

Need tööriistad on integreeritud otse päringusse:

response = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="What is the latest news on AI?",
    tools=[{"type": "web_search"}]
)

Chat Completions toetab funktsioonide kutsumist (arendaja defineeritud tööriistad), kuid mitte neid xAI hallatavaid serveri tööriistu.

Millal kasutada Chat Completionsi?

Chat Completions jääb õigeks valikuks mitmes stsenaariumis:

  • Migratsioon OpenAI-st: sinu olemasolev kood töötab ilma suuremate muudatusteta
  • Mitme teenusepakkuja kasutamine: soovid vahetada sama koodiga OpenAI, Anthropicu ja xAI vahel
  • Kolmandate osapoolte raamistikud: LangChain, LlamaIndex, Haystack ja enamik raamistikke kasutavad Chat Completionsi formaati
  • Täielik kontroll: soovid ajalugu ise hallata (kokkuvõtete tegemine, filtreerimine, muutmine)

Millal kasutada Responses API-t?

Responses API on eelistatav järgmistel juhtudel:

  • Uued projektid: kasuta algusest peale uusimaid funktsioone
  • Serveri tööriistad: vajad veebiotsingut, koodi täitmist või X-i otsingut
  • Pikad vestlused: pole vaja iga päringuga ajalugu uuesti saata
  • Krüpteeritud arutluskäik: juurdepääs arutluskäigu sisule järjepidevuse tagamiseks päringute vahel

Peamised punktid

  • Chat Completions on olekuvaene (sina haldad ajalugu), Responses API on olekuga (server haldab)
  • Responses API pakub eksklusiivseid serveri tööriistu: web_search, x_search, code_interpreter
  • Chat Completionsil on täielik OpenAI ühilduvus, Responses API on spetsiifiline xAI-le
  • Mõlemad lõpp-punktid arveldavad kogu vestluse ajaloo eest
  • Kasuta Chat Completionsi ühilduvuse jaoks, Responses API-t uute funktsioonide jaoks