Kāpēc lietot Responses API?
Šajā lapā
Jauns galapunkts jaunām ambīcijām
Responses API ir galvenais jaunais galapunkts no xAI darbam ar Grok modeļiem. Ja jau esi iepazinies ar Chat Completions galapunktu (saderīgu ar OpenAI), droši vien brīnies, kāpēc xAI ir izveidojis otro galapunktu. Atbilde slēpjas vienā vārdā: evolūcija.
Chat Completions joprojām ir pieejams atpakaļsaderībai ar OpenAI SDK, taču xAI visas jaunās platformas funkcijas vispirms pievieno tieši Responses API. Šis ir galapunkts, kurā ir vērts ieguldīt laiku apguvei.
Ar stāvokli vai bez tā: fundamentālās izmaiņas
Būtiskākā atšķirība starp abiem galapunktiem ir veids, kā tie apstrādā sarunas stāvokli.
Chat Completions (bez stāvokļa)
Izmantojot Chat Completions, katrs pieprasījums ir neatkarīgs. Ar katru izsaukumu tev ir jānosūta visa sarunas vēsture:
{
"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."}
]
}
Jo garāka saruna, jo lielāks ir pieprasījums. Kontekstu tev ir jāpārvalda pašam.
Responses API (ar stāvokli)
Izmantojot Responses API, xAI serveris saglabā vēsturi. Tev vienkārši jānosūta jaunais ziņojums un atsauce uz iepriekšējo atbildi:
{
"model": "grok-4.20-0309-reasoning",
"input": "Tell me about AI.",
"previous_response_id": "resp-abc123"
}
Serveris tavā vietā atjauno pilnu kontekstu. Mazāk datu pārsūtīšanai, mazāk koda rakstīšanai, mazāk iespējamo kļūdu.
Ekskluzīvas funkcijas
Vairākas funkcijas ir pieejamas tikai caur Responses API:
- Dabīgie servera rīki:
web_search,x_searchuncode_interpreterdarbojas tieši xAI serveros bez jebkādas konfigurācijas tavā pusē - Sarunu ķēdēšana: izmantojot
previous_response_id, modelis saglabā visu kontekstu, tev to atkārtoti nosūtot - Pastāvīga glabāšana: ar
store: truetavas atbildes tiek glabātas 30 dienas un ir atgūstamas, izmantojot GET - Šifrēta spriešana: iegūsti jaunāko Grok modeļu iekšējo spriešanu šifrētā veidā, lai to izmantotu turpmākos pieprasījumos
- Detalizēta izmaksu uzskaites:
cost_in_nano_usdkatrā atbildē precīzai tēriņu kontrolei
Kad lietot kurus galapunktus?
Izmanto Chat Completions tikai tad, ja migrē esošu projektu no OpenAI API un nevari uzreiz modificēt savu kodu.
Jebkuram jaunam projektam izmanto Responses API. Tas ir vienkāršāks, jaudīgāks un saņems visus nākotnes xAI platformas uzlabojumus.
Galvenās atziņas
- Responses API ir xAI galvenais galapunkts; Chat Completions ir novecojis
- Tas ir ar stāvokli: serveris pārvalda sarunas vēsturi
- Tas piedāvā dabīgos servera rīkus (meklēšana tīmeklī, X, koda interpretators)
- Pastāvīga glabāšana ļauj atsākt sarunas pat pēc 30 dienām
- Jebkuram jaunam projektam būtu jāizmanto Responses API