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

Miks vastuste API?

Õppetund 1 / 16 Värskendatud 28. juuli 2026 Arendajatele
Sellel lehel
  1. Uus lõpp-punkt uutele ambitsioonidele
  2. Olekuline vs olekuta: fundamentaalne muutus
  3. Eksklusiivsed funktsioonid
  4. Millal kumb lõpp-punkt kasutada?
  5. Peamised punktid

Uus lõpp-punkt uutele ambitsioonidele

Vastuste API (Responses API) on xAI peamine uus lõpp-punkt suhtlemiseks Groki mudelitega. Kui tunned juba vestluse lõpetamise lõpp-punkti (Chat Completions, OpenAI-ga ühilduv), imestad ilmselt, miks xAI lõi teise lõpp-punkti. Vastus taandub ühele sõnale: areng.

Vestluse lõpetamise lõpp-punkt jääb kättesaadavaks tagasiühilduvuse tagamiseks OpenAI SDK-dega, kuid xAI lisab kõik uued platvormi funktsioonid esmalt just vastuste API-le. See on lõpp-punkt, mille õppimisse tasub investeerida.

Olekuline vs olekuta: fundamentaalne muutus

Kõige olulisem erinevus nende kahe lõpp-punkti vahel seisneb selles, kuidas need käsitlevad vestluse olekut.

Vestluse lõpetamine (olekuta)

Vestluse lõpetamise korral on iga päring sõltumatu. Pead iga väljakutsega kaasa saatma kogu vestluse ajaloo:

{
  "model": "grok-4.20-0309-reasoning",
  "messages": [
    {"role": "system", "content": "You are an assistant."},
    {"role": "user", "content": "Hello"},
    {"role": "assistant", "content": "Hello! How can I help you?"},
    {"role": "user", "content": "Tell me about AI."}
  ]
}

Mida pikem on vestlus, seda suurem on päring. Sa haldad konteksti ise.

Vastuste API (olekuline)

Vastuste API puhul säilitab xAI server ajaloo. Saadad lihtalt oma uue sõnumi ja viite eelmisele vastusele:

{
  "model": "grok-4.20-0309-reasoning",
  "input": "Tell me about AI.",
  "previous_response_id": "resp-abc123"
}

Server rekonstrueerib sinu eest täieliku konteksti. Vähem edastatavaid andmeid, vähem kirjutatavat koodi, vähem võimalikke vigu.

Olekuline
Serveripoolne ajalugu
30 päeva
Vastuste säilitamine
4
Sisseehitatud serveri tööriistad
128
Tööriistade maksimaalne arv päringu kohta

Eksklusiivsed funktsioonid

Mitmed funktsioonid on kättesaadavad ainult vastuste API kaudu:

  • Pärisoma serveri tööriistad: web_search, x_search ja code_interpreter töötavad otse xAI serverites ilma sinupoolse konfiguratsioonita
  • Vestluse aheldamine: previous_response_id kaudu säilitab mudel kogu konteksti, ilma et peaksid seda uuesti saatma
  • Püsiv salvestus: võtme store: true abil säilitatakse su vastused 30 päeva ja neid saab GET-päringuga uuesti kätte saada
  • Krüpteeritud arutluskäik: värskete Groki mudelite sisemise arutluskäigu saad kätte krüpteeritud kujul, et seda järgnevates päringutes uuesti kasutada
  • Üksikasjalik kulude jälgimine: iga vastus sisaldab välja cost_in_nano_usd, mis võimaldab oma kulutusi täpselt kontrollida

Millal kumb lõpp-punkt kasutada?

Kasuta vestluse lõpetamise lõpp-punkti ainult siis, kui viid olemasolevat projekti üle OpenAI API-lt ja ei saa oma koodi kohe muuta.

Iga uue projekti puhul kasuta vastuste API-t. See on lihtsam, võimsam ja saab tulevikus kõik xAI platvormi täiustused esimesena.

Peamised punktid

  • Vastuste API on xAI peamine lõpp-punkt – vestluse lõpetamine on iganenud
  • See on olekuline: server haldab vestluse ajalugu
  • See pakub pärisomaid serveri tööriistu (veebiotsing, X, koodi interpreter)
  • Püsiv salvestus võimaldab vestlusi jätkata kuni 30 päeva hiljem
  • Iga uus projekt peaks kasutama vastuste API-t