Siirry pääsisältöön
Suomi— Valitse kieli
Valikko

Chat Completions vs Responses API: Vertailu

Oppitunti 11 / 12 Päivitetty 30. heinäkuuta 2026 Kehittäjä
Tällä sivulla
  1. Kaksi päätepistettä, kaksi filosofiaa
  2. Tilanhallinta: perustavanlaatuinen ero
  3. Eksklusiiviset työkalut ja ominaisuudet
  4. Milloin käyttää Chat Completionsia?
  5. Milloin käyttää Responses API:a?
  6. Keskeiset asiat

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 verkkohaku
  • x_search: haku X:n (Twitter) julkaisuista
  • code_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