Pereiti prie pagrindinio turinio
Lietuvių— Pasirinkite kalbą
Meniu

Chat Completions ir Responses API: palyginimas

Paskaita 11 iš 12 Atnaujinta 2026 m. liepos 30 d. Kūrėjas
Šiame puslapyje
  1. Du galiniai taškai, dvi filosofijos
  2. Būsenos valdymas: esminis skirtumas
  3. Išskirtiniai įrankiai ir funkcijos
  4. Kada naudoti Chat Completions?
  5. Kada naudoti Responses API?
  6. Svarbiausi punktai

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 laiku
  • x_search: paieška „X“ („Twitter“) įrašuose
  • code_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