Ga naar hoofdinhoud
Nederlands— Kies een taal
Menu

Responses API: Het reasoning-object in detail

Les 7 van 12 Bijgewerkt op 28 juli 2026 Ontwikkelaar
Op deze pagina
  1. Het reasoning-object in de Responses API
  2. Volledige structuur van het reasoning-object
  3. Verschil tussen samenvatting en versleuteld redeneren
  4. Veelvoorkomende combinaties
  5. Wanneer u het reasoning-object weglaat
  6. Belangrijkste punten

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 taken
  • medium: een balans tussen diepgang en snelheid
  • high: 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:

AspectSamenvatting (generate_summary)Versleuteld (include)
LeesbaarheidPlatte tekst, begrijpelijkVersleuteld, ondoorzichtig
Primair gebruikWeergave voor gebruiker, auditHergebruik in volgende verzoeken
Activeringreasoning.generate_summary: trueinclude: ["reasoning.encrypted_content"]
DetailniveauBeknopte samenvattingVolledig redeneerproces
BeschikbaarheidAlleen Responses APIAlleen 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
  • effort stuurt de diepgang (low, medium, high)
  • generate_summary produceert 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 reasoning is geldig: het model redeneert dan met de standaardinstellingen