Chat Completions vs Responses API: Vergelijking
Op deze pagina
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 webzoekopdrachtenx_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