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

Perintötila ja tilaton periaate

Oppitunti 1 / 12 Päivitetty 3. marraskuuta 2026 Kehittäjä
Tällä sivulla
  1. Chat Completions -päätepiste xAI-ekosysteemissä
  2. Tilaton päätepiste: lähetä kaikki jokaisella pyynnöllä
  3. Keskeiset asiat

Päivitetty 3. marraskuuta 2026 xAI:n parhaiden käytäntöjen mukaisesti: xAI luokittelee nyt Chat Completions -rajapinnan vanhentuneeksi ja suosittelee Responses API:a Grokin päättelymalleille. Konkreettinen syy: Chat Completionsista puuttuu kenttä mallin salatulle päättelylle, joten jokaisessa usean vuorovaikutuskerran keskustelussa tai työkalukutsussa edellisten kierrosten päättelytieto katoaa. Uudet ominaisuudet julkaistaan myös ensisijaisesti Responses API:ssa. Lähteet: xAI Best Practices · Chat Completions (legacy).

Chat Completions -päätepiste xAI-ekosysteemissä

xAI API tarjoaa kaksi ensisijaista päätepistettä Grok-mallien kanssa työskentelyyn: Responses API (ensisijainen päätepiste) ja Chat Completions -päätepiste. Jälkimmäinen on merkitty vanhentuneeksi: se toimii edelleen täysin, mutta uudet ominaisuudet priorisoidaan nyt Responses API:lle.

Miksi sinun kannattaa sitten välittää siitä? Koska Chat Completions on ekosysteemin laajimmin käytetty päätepiste. Kaikki olemassa olevat OpenAI SDK:t, kehykset kuten LangChain tai LlamaIndex sekä tuhannet oppaat käyttävät tätä muotoa. Jos siirryt toiselta tarjoajalta tai työskentelet kolmansien osapuolten työkalujen kanssa, tämä on todennäköisesti ensimmäinen käyttämäsi päätepiste.

Perintö
Virallinen status
Tilaton
Ei palvelintilaa
OpenAI
Yhteensopiva muoto
3600s
Suositeltu aikakatkaisu

Tilaton päätepiste: lähetä kaikki jokaisella pyynnöllä

Chat Completionsin perusperiaate on, että se on tilaton: palvelin ei säilytä keskusteluhistoriaa. Sinun on sisällytettävä koko edellisten viestien historia jokaiseen pyyntöön.

Tämä tarkoittaa käytännössä sitä, että 10 vaihtoa sisältävässä keskustelussa 11. pyyntösi on sisällettävä 10 edellistä viestiä (käyttäjä + avustaja) sekä uusi viesti. Sovelluksesi hallinnoi tätä historiaa.

{
  "model": "grok-4.20-0309-reasoning",
  "messages": [
    {"role": "system", "content": "You are a helpful assistant."},
    {"role": "user", "content": "Hello!"},
    {"role": "assistant", "content": "Hello! How can I help you?"},
    {"role": "user", "content": "Explain deep learning to me."}
  ]
}

Tässä esimerkissä kolme ensimmäistä viestiä edustavat keskusteluhistoriaa. Vain viimeinen on uusi käyttäjän viesti. Malli tarvitsee kaiken tämän kontekstin tuottaakseen johdonmukaisen vastauksen.

Käytännön vaikutukset

Tilattomalla lähestymistavalla on useita vaikutuksia:

  • Täysi hallinta: päätät tarkasti, mitkä viestit lähetetään mallille. Voit suodattaa, tiivistää tai muokata historiaa ennen jokaista kutsua.
  • Suhteutuvat kustannukset: jokaisesta pyynnöstä veloitetaan kaikki lähetetyt tokenit, historia mukaan lukien. Mitä pidempi keskustelu, sitä kalliimmaksi jokainen vaihto tulee.
  • Ei palvelinpysyvyyttä: xAI:n puolella ei säilytetä dataa pyyntöjen välillä. Tämä on etu tietosuojan kannalta, mutta se vaatii sinua hallinnoimaan pysyvyyttä itse.

Vertailu Responses API:hin

Responses API on sen sijaan tilallinen: se pitää historiaa yllä palvelinpuolella previous_response_id:n avulla. Sinun ei tarvitse lähettää edellisiä viestejä uudelleen – pelkkä tunniste riittää. Vastaukset voidaan säilyttää jopa 30 päivää asetuksella store: true.

Valinta näiden kahden välillä riippuu käyttötarkoituksestasi. Jos työskentelet olemassa olevan OpenAI SDK:n kanssa tai siirryt toiselta tarjoajalta, Chat Completions on looginen lähtökohta. Uutta projektia varten Responses API on suositeltava.

Keskeiset asiat

  • Chat Completions on merkitty vanhentuneeksi, mutta se toimii edelleen täysin ja on yhteensopiva OpenAI-ekosysteemin kanssa
  • Päätepiste on tilaton: sinun on lähetettävä koko historia uudelleen jokaisella pyynnöllä
  • Jokaisen pyynnön kustannus sisältää kaikki historiatokenit
  • Responses API tarjoaa tilallisen vaihtoehdon palvelinpuolen pysyvyydellä
  • Päättelymalleille suositellaan 3600 sekunnin aikakatkaisua