Perintötila ja tilaton periaate
Tällä sivulla
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.
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