Chat Completions ir Responses API: palyginimas
Šiame puslapyje
Du galiniai taškai, dvi filosofijos
xAI siūlo du galinius taškai sąveikai su Grok modeliais: „Chat Completions“ (/v1/chat/completions) ir „Responses API“ (/v1/responses). Suprasti jų skirtumus yra būtina norint pasirinkti tinkamą galinį tašką savo projektui ir suplanuoti galimą migraciją.
| Aspektas | Chat Completions | API Responses |
|---|---|---|
| Būsena | Senasis (Legacy) | Pagrindinis (rekomenduojamas) |
| Būsenos valdymas | Be būsenos (siunčiama istorija) | Su būsena (previous_response_id) |
| Saugojimas serveryje | Ne | Taip (30 dienų, kai store: true) |
| Pokalbis | Žinučių masyvas | Susietas pagal ID |
| Serverio įrankiai | Tik funkcijų kvietimas | web_search, x_search, code_interpreter, functions |
| Šifruotas samprotavimas | Ne | Taip (encrypted_content) |
| Naujos funkcijos | Nėra prioritetas | Prioritetas |
| Suderinamumas su OpenAI | Visiškas | Dalinis |
Būsenos valdymas: esminis skirtumas
Chat Completions: istoriją valdai pats
Kiekvieno užklausos metu privalai iš naujo siųsti visą pokalbio istoriją:
# Chat Completions — kiekvieną kartą siunčiama viskas iš naujo
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: istoriją valdo serveris
Naudojant „Responses API“, pokalbiui tęsti pakanka paprasto identifikatoriaus:
# Responses API — tik ankstesnio atsakymo 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
)
Serveris išlaiko kontekstą ir automatiškai atkuria istoriją. Nemoki mažiau už žetonus (istorija vis tiek apmokestinama), tačiau supaprastini savo kodą ir sumažini užklausų dydį.
Išskirtiniai įrankiai ir funkcijos
„Responses API“ suteikia prieigą prie serverio įrankių, kurių „Chat Completions“ neturi:
web_search: paieška internete realiuoju laikux_search: paieška „X“ („Twitter“) įrašuosecode_interpreter: Python kodo vykdymas serveryje
Šie įrankiai integruojami tiesiai į užklausą:
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="What is the latest news on AI?",
tools=[{"type": "web_search"}]
)
„Chat Completions“ palaiko funkcijų kvietimą (kūrėjo apibrėžtus įrankius), tačiau ne šiuos xAI valdomus serverio įrankius.
Kada naudoti Chat Completions?
„Chat Completions“ lieka tinkamas pasirinkimas keliose situacijose:
- Migracija iš OpenAI: tavo esamas kodas veikia be didelių pakeitimų
- Keli tiekėjai: nori perjungti tarp OpenAI, Anthropic ir xAI naudojant tą patį kodą
- Trečiųjų šalių sistemos: LangChain, LlamaIndex, Haystack ir dauguma sistemų naudoja „Chat Completions“ formatą
- Visiška kontrolė: nori pats valdyti istoriją (apibendrinimas, filtravimas, modifikavimas)
Kada naudoti Responses API?
„Responses API“ yra pageidautinas:
- Naujiems projektams: nuo pat pradžių naudok naujausias funkcijas
- Serverio įrankiams: reikia interneto paieškos, kodo vykdymo arba „X“ paieškos
- Ilgiems pokalbiams: nereikia siųsti istorijos su kiekviena užklausa
- Šifruotam samprotavimui: prieiga prie samprotavimo turinio tęstinumui tarp užklausų
Svarbiausi punktai
- „Chat Completions“ yra be būsenos (istoriją valdai pats), o „Responses API“ yra su būsena (valdo serveris)
- „Responses API“ siūlo išskirtinius serverio įrankius: web_search, x_search, code_interpreter
- „Chat Completions“ turi visišką suderinamumą su OpenAI, o „Responses API“ yra specifinis xAI
- Abu galiniai taškai apmokestina visą pokalbio istoriją
- Naudok „Chat Completions“ suderinamumui, o „Responses API“ – naujoms funkcijoms