Responses API: Het reasoning-object in detail
Op deze pagina
Het reasoning-object in de Responses API
De Responses API van xAI biedt fijnmazige controle over het redeneerproces via het reasoning-object. Deze parameter is uitsluitend beschikbaar in de Responses API (niet in Chat Completions) en stelt u in staat drie aspecten van het redeneren te configureren: inspanning, het genereren van een samenvatting en het formaat van die samenvatting.
Volledige structuur van het reasoning-object
{
"model": "grok-4.20-0309-reasoning",
"input": "Your question here",
"reasoning": {
"effort": "medium",
"generate_summary": true,
"summary": "auto"
}
}
effort
Stuurt de diepgang van het denkproces van het model. Er zijn drie mogelijke waarden:
low: minimale denkinspanning, geschikt voor eenvoudige takenmedium: een balans tussen diepgang en snelheidhigh: maximale denkinspanning voor complexe problemen
Deze parameter is het equivalent in de Responses API van reasoning_effort in Chat Completions, maar met de toegevoegde waarde medium.
generate_summary
Een boolean die aangeeft of het model naast het eindantwoord ook een samenvatting van zijn redeneerproces moet produceren.
{
"model": "grok-4.20-0309-reasoning",
"input": "Compare the advantages of quicksort and mergesort.",
"reasoning": {
"effort": "high",
"generate_summary": true
}
}
Wanneer generate_summary op true is ingesteld, bevat het antwoord een extra element met een beknopte samenvatting van het redeneerproces. Deze samenvatting is in platte tekst (niet versleuteld), wat het onderscheidt van reasoning.encrypted_content.
summary
Stuurt het formaat van de gegenereerde samenvatting. Op dit moment is "auto" de enige gedocumenteerde waarde; hiermee kiest het model zelf het meest geschikte formaat.
{
"reasoning": {
"effort": "high",
"generate_summary": true,
"summary": "auto"
}
}
Verschil tussen samenvatting en versleuteld redeneren
Deze twee mechanismen vullen elkaar aan, maar zijn verschillend:
| Aspect | Samenvatting (generate_summary) | Versleuteld (include) |
|---|---|---|
| Leesbaarheid | Platte tekst, begrijpelijk | Versleuteld, ondoorzichtig |
| Primair gebruik | Weergave voor gebruiker, audit | Hergebruik in volgende verzoeken |
| Activering | reasoning.generate_summary: true | include: ["reasoning.encrypted_content"] |
| Detailniveau | Beknopte samenvatting | Volledig redeneerproces |
| Beschikbaarheid | Alleen Responses API | Alleen Responses API |
U kunt beide gelijktijdig inschakelen om zowel een leesbare samenvatting als het volledige versleutelde redeneerproces te ontvangen:
response = client.responses.create(
model="grok-4.20-0309-reasoning",
input="Demonstrate the infinitude of prime numbers.",
reasoning={
"effort": "high",
"generate_summary": True,
"summary": "auto"
},
include=["reasoning.encrypted_content"]
)
Veelvoorkomende combinaties
Minimaal gebruik: alleen inspanning
{
"reasoning": {
"effort": "low"
}
}
Het model redeneert met minimale inspanning. Er wordt geen samenvatting teruggegeven en ook geen versleuteld redeneerproces.
Gemiddeld gebruik: inspanning + samenvatting
{
"reasoning": {
"effort": "medium",
"generate_summary": true,
"summary": "auto"
}
}
Het model redeneert en levert een leesbare samenvatting. Ideaal voor applicaties die het denkproces aan de gebruiker willen tonen.
Volledig gebruik: inspanning + samenvatting + versleuteld
{
"reasoning": {
"effort": "high",
"generate_summary": true,
"summary": "auto"
},
"include": ["reasoning.encrypted_content"]
}
Maximale configuratie: diepgaand redeneren, een leesbare samenvatting en versleutelde inhoud voor hergebruik. Reserveer dit voor gevallen waarin u alles nodig heeft.
Wanneer u het reasoning-object weglaat
Als u het redeneerproces niet hoeft te sturen, kunt u de parameter reasoning eenvoudig weglaten. Het model gebruikt dan zijn standaardinstellingen. Dit blijft geldig en het model zal nog steeds redeneren (aangezien grok-4.20-0309-reasoning van nature een redeneermodel is).
Belangrijkste punten
- Het
reasoning-object is uitsluitend beschikbaar in de Responses API effortstuurt de diepgang (low,medium,high)generate_summaryproduceert een leesbare samenvatting van het redeneerproces (platte tekst)summary: "auto"laat het model het formaat van de samenvatting kiezen- U kunt een samenvatting en versleuteld redeneren combineren in hetzelfde verzoek
- Het weglaten van
reasoningis geldig: het model redeneert dan met de standaardinstellingen