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

Miksi Responses API?

Oppitunti 1 / 16 Päivitetty 28. heinäkuuta 2026 Kehittäjä
Tällä sivulla
  1. Uusi päätepiste uusille tavoitteille
  2. Tilallinen vs. tilaton: perustavanlaatuinen muutos
  3. Eksklusiiviset ominaisuudet
  4. Milloin käyttää kumpaakin päätepistettä?
  5. Keskeiset asiat

Uusi päätepiste uusille tavoitteille

Responses API on xAI:n ensisijainen uusi päätepiste vuorovaikutukseen Grok-mallien kanssa. Jos tunnet jo Chat Completions -päätepisteen (OpenAI-yhteensopiva), saatat ihmetellä, miksi xAI loi toisen päätepisteen. Vastaus tiivistyy yhteen sanaan: kehitys.

Chat Completions pysyy käytettävissä taaksepäin yhteensopivuuden vuoksi OpenAI SDK:iden kanssa, mutta xAI lisää kaikki uudet alustan ominaisuudet ensin Responses API:hun. Tämä on päätepiste, johon kannattaa sijoittaa oppimisesi.

Tilallinen vs. tilaton: perustavanlaatuinen muutos

Tärkein ero näiden kahden päätepisteen välillä on se, miten ne käsittelevät keskustelun tilaa.

Chat Completions (tilaton)

Chat Completionsissa jokainen pyyntö on riippumaton. Sinun on lähetettävä koko keskusteluhistoria jokaisella kutsulla:

{
  "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."}
  ]
}

Mitä pidempi keskustelu, sitä suurempi pyyntö. Hallitset kontekstin itse.

Responses API (tilallinen)

Responses API:ssa xAI-palvelin säilyttää historian. Lähetät vain uuden viestisi ja viittauksen edelliseen vastaukseen:

{
  "model": "grok-4.20-0309-reasoning",
  "input": "Tell me about AI.",
  "previous_response_id": "resp-abc123"
}

Palautin rakentaa koko kontekstin puolestasi. Vähemmän siirrettävää dataa, vähemmän kirjoitettavaa koodia, vähemmän mahdollisia virheitä.

Tilallinen
Palvelinpuolen historia
30 päivää
Vastausten säilytys
4
Sisäänrakennetut palvelintyökalut
128
Työkalujen enimmäismäärä pyyntöä kohti

Eksklusiiviset ominaisuudet

Useat ominaisuudet ovat saatavilla vain Responses API:n kautta:

  • Natiivit palvelintyökalut: web_search, x_search ja code_interpreter suoritetaan suoraan xAI:n palvelimilla ilman minkäänlaista konfigurointia omalta puoleltasi
  • Keskusteluketjutus: previous_response_id:n avulla malli säilyttää koko kontekstin, sinun ei tarvitse lähettää sitä uudelleen
  • Pysyvä tallennus: asetuksella store: true vastauksesi säilyvät 30 päivää ja ne ovat haettavissa GET-pyynnöllä
  • Salattu päättely: nouda viimeisimpien Grok-mallien sisäinen päättely salatussa muodossa käyttääksesi sitä myöhemmissä pyynnöissä
  • Hienojakoinen kustannusseuranta: cost_in_nano_usd jokaisessa vastauksessa antaa tarkan kontrollin kulutukseesi

Milloin käyttää kumpaakin päätepistettä?

Käytä Chat Completions -päätepistettä vain, jos siirrät olemassa olevaa projektia OpenAI API:sta etkä voi muokata koodiasi välittömästi.

Kaikissa uusissa projekteissa käytä Responses API:ta. Se on yksinkertaisempi, tehokkaampi ja saa kaikki xAI-alustan tulevat parannukset.

Keskeiset asiat

  • Responses API on xAI:n ensisijainen päätepiste – Chat Completions on vanhentunut
  • Se on tilallinen: palvelin hallitsee keskusteluhistoriaa
  • Se tarjoaa natiivit palvelintyökalut (web-haku, X, kooditulkki)
  • Pysyvä tallennus mahdollistaa keskustelujen jatkamisen jopa 30 päivän kuluttua
  • Kaikkien uusien projektien tulisi käyttää Responses API:ta