Chat Completions vs Responses API: Vertailu
Tällä sivulla
Kaksi päätepistettä, kaksi filosofiaa
xAI tarjoaa kaksi päätepistettä vuorovaikutukseen Grok-mallien kanssa: Chat Completions (/v1/chat/completions) ja Responses API (/v1/responses). Niiden erojen ymmärtäminen on välttämätöntä, jotta voit valita projektillesi sopivan päätepisteen ja suunnitella mahdollisen migraation.
| Aspect | Chat Completions | API Responses |
|---|---|---|
| Status | Legacy | Primary (recommended) |
| State management | Stateless (send history) | Stateful (previous_response_id) |
| Server storage | No | Yes (30 days with store: true) |
| Conversation | Message array | Chained by ID |
| Server tools | Function calling only | web_search, x_search, code_interpreter, functions |
| Encrypted reasoning | No | Yes (encrypted_content) |
| New features | Not prioritized | Prioritized |
| OpenAI compatibility | Full | Partial |
Tilanhallinta: perustavanlaatuinen ero
Chat Completions: sinä hallitset historiaa
Jokaisella pyynnöllä sinun on lähetettävä koko keskustelu uudelleen:
# Chat Completions — resend everything every time
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: palvelin hallitsee historiaa
Responses API:ssa pelkkä tunniste riittää keskustelun jatkamiseen:
# Responses API — just the previous response 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
)
Palvelin säilyttää kontekstin ja rakentaa historian uudelleen automaattisesti. Et maksa vähemmän tokeneista (historia laskutetaan edelleen), mutta koodisi yksinkertaistuu ja pyyntöjesi koko pienenee.
Eksklusiiviset työkalut ja ominaisuudet
Responses API tarjoaa pääsyn palvelintyökaluihin, joita Chat Completions ei tue:
web_search: reaaliaikainen verkkohakux_search: haku X:n (Twitter) julkaisuistacode_interpreter: Python-koodin suoritus palvelimella
Nämä työkalut integroidaan suoraan pyyntöön:
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="What is the latest news on AI?",
tools=[{"type": "web_search"}]
)
Chat Completions tukee funktiokutsuja (kehittäjän määrittelemät työkalut), mutta ei näitä xAI:n hallinnoimia palvelintyökaluja.
Milloin käyttää Chat Completionsia?
Chat Completions on oikea valinta useissa tilanteissa:
- Migraatio OpenAI:sta: olemassa oleva koodisi toimii ilman suuria muutoksia
- Useita tarjoajia: haluat vaihtaa OpenAI:n, Anthropicin ja xAI:n välillä samalla koodilla
- Kolmannen osapuolen kehykset: LangChain, LlamaIndex, Haystack ja useimmat kehykset käyttävät Chat Completions -muotoa
- Täysi kontrolli: haluat hallita historiaa itse (tiivistäminen, suodatus, muokkaus)
Milloin käyttää Responses API:a?
Responses API on suositeltava seuraavissa tapauksissa:
- Uudet projektit: hyödy uusimmista ominaisuuksista alusta alkaen
- Palvelintyökalut: tarvitset verkkohakua, koodin suorittamista tai X-hakua
- Pitkät keskustelut: historiaa ei tarvitse lähettää uudelleen jokaisella pyynnöllä
- Salattu päättely: pääsy päättelysisältöön jatkuvuuden varmistamiseksi pyyntöjen välillä
Keskeiset asiat
- Chat Completions on tilaton (sinä hallitset historiaa), Responses API on tilallinen (palvelin hallitsee)
- Responses API tarjoaa eksklusiivisia palvelintyökaluja: web_search, x_search, code_interpreter
- Chat Completionsissa on täysi OpenAI-yhteensopivuus, Responses API on spesifi xAI:lle
- Molemmat päätepisteet laskuttavat koko keskusteluhistoriasta
- Käytä Chat Completionsia yhteensopivuuden vuoksi, Responses API:a uusien ominaisuuksien vuoksi