Legacy-status en het stateless-principe
Op deze pagina
Bijgewerkt op 3 november 2026 op basis van best practices van xAI: xAI classificeert Chat Completions nu als verouderd (legacy) en raadt de Responses API aan voor Grok-redeneermodellen. Concreet reden: Chat Completions mist een veld voor de versleutelde redenering van het model, waardoor bij elke conversatie met meerdere beurten of tool-aanroepen de redenering van eerdere beurten verloren gaat. Nieuwe functies worden ook eerst uitgerold op de Responses API. Bronnen: xAI Best Practices · Chat Completions (legacy).
Het Chat Completions-eindpunt in het xAI-ecosysteem
De xAI API biedt twee hoofdeindpunten voor interactie met Grok-modellen: de Responses API (het primaire eindpunt) en het Chat Completions-eindpunt. Dit laatste is gemarkeerd als legacy: het blijft volledig functioneel, maar nieuwe functies krijgen nu voorrang op de Responses API.
Waarom zou u zich hier dan mee bezighouden? Omdat Chat Completions het meest gebruikte eindpunt in het ecosysteem blijft. Alle bestaande OpenAI SDK’s, frameworks zoals LangChain of LlamaIndex, en duizenden tutorials gebruiken dit formaat. Als u migreert vanaf een andere provider of werkt met tools van derden, is dit waarschijnlijk het eindpunt dat u als eerste zult gebruiken.
Een stateless eindpunt: stuur alles mee bij elk verzoek
Het fundamentele principe van Chat Completions is dat het stateless is: de server bewaart geen conversatiegeschiedenis. Bij elke oproep moet u de volledige geschiedenis van eerdere berichten in uw verzoek opnemen.
Concreet betekent dit dat voor een conversatie met 10 uitwisselingen, uw 11e verzoek de 10 vorige berichten (gebruiker + assistent) plus het nieuwe bericht moet bevatten. Uw applicatie beheert deze geschiedenis.
{
"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."}
]
}
In dit voorbeeld vertegenwoordigen de eerste drie berichten de conversatiegeschiedenis. Alleen het laatste bericht is het nieuwe gebruikersbericht. Het model heeft al deze context nodig om een samenhangend antwoord te produceren.
Praktische implicaties
Deze stateless-aanpak heeft verschillende implicaties:
- Volledige controle: u bepaalt precies welke berichten naar het model worden verzonden. U kunt de geschiedenis filteren, samenvatten of wijzigen voordat u elke oproep doet.
- Evenredige kosten: elk verzoek wordt gefactureerd voor alle verzonden tokens, inclusief de geschiedenis. Hoe langer de conversatie, hoe duurder elke uitwisseling wordt.
- Geen serverpersistentie: er worden geen gegevens opgeslagen aan de kant van xAI tussen verzoeken door. Dit is een voordeel voor de privacy, maar vereist dat u de persistentie zelf beheert.
Vergelijking met de Responses API
De Responses API is daarentegen stateful: deze bewaart de geschiedenis aan de serverzijde via previous_response_id. U hoeft eerdere berichten niet opnieuw te verzenden; een eenvoudige identifier volstaat. Antwoorden kunnen tot 30 dagen worden bewaard met store: true.
De keuze tussen de twee hangt af van uw use case. Als u werkt met een bestaande OpenAI SDK of migreert vanaf een andere provider, is Chat Completions het logische startpunt. Voor een nieuw project wordt de Responses API aanbevolen.
Belangrijkste punten
- Chat Completions is gemarkeerd als legacy, maar blijft volledig functioneel en compatibel met het OpenAI-ecosysteem
- Het eindpunt is stateless: u moet bij elk verzoek de volledige geschiedenis opnieuw verzenden
- De kosten van elk verzoek omvatten alle tokens van de geschiedenis
- De Responses API biedt een stateful alternatief met persistentie aan de serverzijde
- Voor redeneermodellen wordt een time-out van 3600 seconden aanbevolen