Miks vastuste API?
Sellel lehel
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.
Eksklusiivsed funktsioonid
Mitmed funktsioonid on kättesaadavad ainult vastuste API kaudu:
- Pärisoma serveri tööriistad:
web_search,x_searchjacode_interpretertöötavad otse xAI serverites ilma sinupoolse konfiguratsioonita - Vestluse aheldamine:
previous_response_idkaudu säilitab mudel kogu konteksti, ilma et peaksid seda uuesti saatma - Püsiv salvestus: võtme
store: trueabil 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