Ga naar hoofdinhoud
Nederlands— Kies een taal
Menu

Waarom de Responses API?

Les 1 van 16 Bijgewerkt op 28 juli 2026 Ontwikkelaar
Op deze pagina
  1. Een nieuw eindpunt voor nieuwe ambities
  2. Stateful vs. Stateless: de fundamentele verandering
  3. Exclusieve functies
  4. Wanneer welk eindpunt gebruiken?
  5. Belangrijkste punten

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.

Stateful
Server-side history
30 days
Response retention
4
Built-in server tools
128
Max tools per request

Exclusieve functies

Verschillende functies zijn alleen beschikbaar via de Responses API:

  • Native servertools: web_search, x_search en code_interpreter draaien direct op xAI-servers, zonder enige configuratie aan uw kant
  • Conversatieketening: via previous_response_id behoudt het model alle context zonder dat u deze opnieuw hoeft te verzenden
  • Persistente opslag: met store: true worden 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_usd in 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