Waarom de Responses API?
Op deze pagina
Een nieuw eindpunt voor nieuwe ambities
De Responses API is het belangrijkste nieuwe eindpunt van xAI voor interactie met Grok-modellen. Als u al vertrouwd bent met het Chat Completions-eindpunt (compatibel met OpenAI), vraagt u zich waarschijnlijk af waarom xAI een tweede eindpunt heeft gecreëerd. Het antwoord komt neer op één woord: evolutie.
Chat Completions blijft beschikbaar voor achterwaartse compatibiliteit met OpenAI SDK’s, maar xAI voegt alle nieuwe platformfuncties eerst toe aan de Responses API. Dit is het eindpunt waarin uw leerinvestering de moeite waard is.
Stateful vs. Stateless: de fundamentele verandering
Het belangrijkste verschil tussen de twee eindpunten is hoe ze de conversatiestatus beheren.
Chat Completions (stateless)
Bij Chat Completions is elk verzoek onafhankelijk. U moet bij elke oproep de volledige conversatiegeschiedenis meesturen:
{
"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."}
]
}
Hoe langer de conversatie, hoe groter het verzoek. U beheert de context zelf.
Responses API (stateful)
Bij de Responses API bewaart de xAI-server de geschiedenis. U stuurt eenvoudigweg uw nieuwe bericht en een verwijzing naar het vorige antwoord:
{
"model": "grok-4.20-0309-reasoning",
"input": "Tell me about AI.",
"previous_response_id": "resp-abc123"
}
De server reconstrueert de volledige context voor u. Minder gegevens om te verzenden, minder code om te schrijven, minder mogelijke fouten.
Exclusieve functies
Verschillende functies zijn alleen beschikbaar via de Responses API:
- Native servertools:
web_search,x_searchencode_interpreterdraaien direct op xAI-servers, zonder enige configuratie aan uw kant - Conversatieketening: via
previous_response_idbehoudt het model alle context zonder dat u deze opnieuw hoeft te verzenden - Persistente opslag: met
store: trueworden uw antwoorden 30 dagen bewaard en zijn ze opvraagbaar via GET - Versleutelde redenering: haal de interne redenering van recente Grok-modellen op in versleutelde vorm om deze in volgende verzoeken te hergebruiken
- Gedetailleerde kostentracking:
cost_in_nano_usdin elk antwoord voor precieze controle over uw uitgaven
Wanneer welk eindpunt gebruiken?
Gebruik Chat Completions alleen als u een bestaand project migreert vanaf de OpenAI API en uw code niet direct kunt aanpassen.
Gebruik voor elk nieuw project de Responses API. Deze is eenvoudiger, krachtiger en ontvangt alle toekomstige verbeteringen van het xAI-platform.
Belangrijkste punten
- De Responses API is het primaire eindpunt van xAI; Chat Completions is verouderd
- Het is stateful: de server beheert de conversatiegeschiedenis
- Het biedt native servertools (webzoekopdracht, X, code-interpreter)
- Met persistente opslag kunt u conversaties tot 30 dagen later hervatten
- Elk nieuw project moet de Responses API gebruiken