Chat Completions pret Responses API: Salīdzinājums
Šajā lapā
Divi galapunkti, divas filozofijas
xAI piedāvā divus galapunktus mijiedarbībai ar Grok modeļiem: Chat Completions (/v1/chat/completions) un Responses API (/v1/responses). Ir būtiski saprast to atšķirības, lai izvēlētos savam projektam piemērotāko galapunktu un saplānotu iespējamo migrāciju.
| Aspekts | Chat Completions | API Responses |
|---|---|---|
| Statuss | Mantojums (Legacy) | Primārais (ieteicams) |
| Stāvokļa pārvaldība | Bez stāvokļa (sūta vēsturi) | Ar stāvokli (previous_response_id) |
| Servera glabātuve | Nē | Jā (30 dienas ar store: true) |
| Saruna | Ziņojumu masīvs | Sasaistīta pēc ID |
| Servera rīki | Tikai funkciju izsaukumi | web_search, x_search, code_interpreter, functions |
| Šifrēta spriešana | Nē | Jā (encrypted_content) |
| Jaunas funkcijas | Nav prioritāte | Prioritāte |
| Saderība ar OpenAI | Pilnīga | Daļēja |
Stāvokļa pārvaldība: fundamentālā atšķirība
Chat Completions: tu pārvaldi vēsturi
Ar katru pieprasījumu tev ir jānosūta visa saruna no jauna:
# Chat Completions — nosūti visu katru reizi
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: serveris pārvalda vēsturi
Izmantojot Responses API, sarunas turpināšanai pietiek ar vienkāršu identifikatoru:
# Responses API — tikai iepriekšējās atbildes 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 saglabā kontekstu un automātiski atjauno vēsturi. Tu nemaksā mazāk par tokeniem (vēsture joprojām tiek tarifēta), taču vienkāršo savu kodu un samazini pieprasījumu apjomu.
Ekskluzīvi rīki un funkcijas
Responses API nodrošina piekļuvi servera rīkiem, ko Chat Completions nepiedāvā:
web_search: meklēšana tiešsaistē reāllaikāx_search: meklēšana X (Twitter) ierakstoscode_interpreter: Python koda izpilde servera pusē
Šie rīki ir tieši integrēti pieprasījumā:
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="What is the latest news on AI?",
tools=[{"type": "web_search"}]
)
Chat Completions atbalsta funkciju izsaukumus (izstrādātāja definētus rīkus), bet ne šos xAI pārvaldītos servera rīkus.
Kad lietot Chat Completions?
Chat Completions joprojām ir pareizā izvēle vairākos scenārijos:
- Migrācija no OpenAI: tavs esošais kods strādā bez lielām izmaiņām
- Vairāki nodrošinātāji: vēlies pārslēgties starp OpenAI, Anthropic un xAI, izmantojot vienu un to pašu kodu
- Trešo pušu ietvari: LangChain, LlamaIndex, Haystack un lielākā daļa ietvaru izmanto Chat Completions formātu
- Pilnīga kontrole: vēlies pats pārvaldīt vēsturi (apkopošana, filtrēšana, modificēšana)
Kad lietot Responses API?
Responses API ir vēlams izmantot, ja:
- Jauni projekti: vēlies uzreiz baudīt jaunākās funkcijas
- Servera rīki: nepieciešama tīmekļa meklēšana, koda izpilde vai X meklēšana
- Garas sarunas: nav jānosūta vēsture ar katru pieprasījumu
- Šifrēta spriešana: piekļuve spriešanas saturam nepārtrauktībai starp pieprasījumiem
Galvenās atziņas
- Chat Completions ir bez stāvokļa (tu pārvaldi vēsturi), savukārt Responses API ir ar stāvokli (pārvalda serveris)
- Responses API piedāvā ekskluzīvus servera rīkus: web_search, x_search, code_interpreter
- Chat Completions nodrošina pilnīgu saderību ar OpenAI, bet Responses API ir specifisks xAI
- Abi galapunkti tarifē visu sarunas vēsturi
- Izmanto Chat Completions saderībai, bet Responses API – jaunām funkcijām