Chat Completions vs Responses API: võrdlus
Sellel lehel
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 veebiotsingx_search: otsing X-i (Twitter) postitustescode_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