Ga naar hoofdinhoud
Nederlands— Kies een taal
Menu

Chat Completions vs Responses API: Vergelijking

Les 11 van 12 Bijgewerkt op 30 juli 2026 Ontwikkelaar
Op deze pagina
  1. Twee eindpunten, twee filosofieën
  2. Statusbeheer: het fundamentele verschil
  3. Exclusieve tools en functies
  4. Wanneer Chat Completions gebruiken?
  5. Wanneer de Responses API gebruiken?
  6. Belangrijkste punten

Twee eindpunten, twee filosofieën

xAI biedt twee eindpunten voor interactie met Grok-modellen: Chat Completions (/v1/chat/completions) en de Responses API (/v1/responses). Het begrijpen van hun verschillen is essentieel om het juiste eindpunt voor uw project te kiezen en eventuele migraties te plannen.

Aspect Chat Completions API Responses
Status Verouderd (Legacy) Primair (aanbevolen)
Statusbeheer Stateless (geschiedenis verzenden) Stateful (previous_response_id)
Serveropslag Nee Ja (30 dagen met store: true)
Conversatie Berichtenarray Gekoppeld via ID
Servertools Alleen function calling web_search, x_search, code_interpreter, functions
Versleutelde redenering Nee Ja (encrypted_content)
Nieuwe functies Geen prioriteit Prioritair
OpenAI-compatibiliteit Volledig Gedeeltelijk

Statusbeheer: het fundamentele verschil

Chat Completions: u beheert de geschiedenis

Bij elk verzoek moet u de volledige conversatie opnieuw verzenden:

# Chat Completions — alles elke keer opnieuw verzenden
response = client.chat.completions.create(
    model="grok-4.20-0309-reasoning",
    messages=[
        {"role": "system", "content": "You are a helpful assistant."},
        {"role": "user", "content": "Hello, my name is Alice."},
        {"role": "assistant", "content": "Hello Alice! How can I help you?"},
        {"role": "user", "content": "What is my first name?"}
    ]
)

Responses API: de server beheert de geschiedenis

Met de Responses API volstaat een eenvoudige identifier om een conversatie voort te zetten:

# Responses API — alleen de ID van de vorige respons
response1 = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="Hello, my name is Alice."
)

response2 = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="What is my first name?",
    previous_response_id=response1.id
)

De server bewaart de context en reconstrueert de geschiedenis automatisch. U betaalt niet minder tokens (de geschiedenis wordt nog steeds gefactureerd), maar u vereenvoudigt uw code en verkleint de grootte van uw verzoeken.

Exclusieve tools en functies

De Responses API biedt toegang tot servertools die Chat Completions niet biedt:

  • web_search: realtime webzoekopdrachten
  • x_search: zoeken in berichten op X (Twitter)
  • code_interpreter: uitvoering van Python-code aan de serverzijde

Deze tools zijn direct in het verzoek geïntegreerd:

response = client.responses.create(
    model="grok-4.20-0309-reasoning",
    input="What is the latest news on AI?",
    tools=[{"type": "web_search"}]
)

Chat Completions ondersteunt function calling (door ontwikkelaars gedefinieerde tools), maar niet deze door xAI beheerde servertools.

Wanneer Chat Completions gebruiken?

Chat Completions blijft de juiste keuze in verschillende scenario’s:

  • Migratie vanaf OpenAI: uw bestaande code werkt zonder grote aanpassingen
  • Meerdere providers: u wilt wisselen tussen OpenAI, Anthropic en xAI met dezelfde code
  • Frameworks van derden: LangChain, LlamaIndex, Haystack en de meeste frameworks gebruiken het Chat Completions-formaat
  • Volledige controle: u wilt de geschiedenis zelf beheren (samenvatten, filteren, wijzigen)

Wanneer de Responses API gebruiken?

De Responses API heeft de voorkeur voor:

  • Nieuwe projecten: profiteer vanaf het begin van de nieuwste functies
  • Servertools: behoefte aan webzoekopdrachten, code-uitvoering of X-zoekopdrachten
  • Lange conversaties: geen behoefte om bij elk verzoek de geschiedenis opnieuw te verzenden
  • Versleutelde redenering: toegang tot redeneerinhoud voor continuïteit tussen verzoeken

Belangrijkste punten

  • Chat Completions is stateless (u beheert de geschiedenis), de Responses API is stateful (server beheert)
  • De Responses API biedt exclusieve servertools: web_search, x_search, code_interpreter
  • Chat Completions heeft volledige OpenAI-compatibiliteit, de Responses API is specifiek voor xAI
  • Beide eindpunten factureren de volledige conversatiegeschiedenis
  • Gebruik Chat Completions voor compatibiliteit, de Responses API voor nieuwe functies