Ga naar hoofdinhoud
Nederlands— Kies een taal
Menu

Aantal reasoning-tokens tellen

Les 8 van 12 Bijgewerkt op 3 november 2026 Ontwikkelaar
Op deze pagina
  1. Reasoning-tokens begrijpen
  2. Het usage-object in Chat Completions
  3. Reasoning-tokens uitlezen in code
  4. Facturatie tegen het output-tarief
  5. De rol van max_completion_tokens
  6. Belangrijkste punten

Les herschreven op 3 november 2026 op basis van de xAI API-referentie (Chat Completions en Responses), de Reasoning-gids en het Reasoning Effort Evals-voorbeeld uit het kookboek: bij xAI telt completion_tokens (of output_tokens) alleen de zichtbare respons; reasoning wordt apart geteld en het totaal is de som van alle drie; de uitvoerlimiet beperkt reasoning niet. De vorige versie beweerde het tegenovergestelde, gebruikte velden van Chat Completions op een Responses API-antwoord, stelde effort in op grok-4.20-0309-reasoning (wat dit niet accepteert) en toonde een screenshot die niet overeenkwam met de API; deze elementen zijn gecorrigeerd of verwijderd. Bronnen: Chat Completions · Responses · Reasoning Effort Evals.

Reasoning-tokens begrijpen

Reasoning-modellen produceren twee soorten tokens: die voor de zichtbare respons en die voor het interne denkproces van het model. Inzicht in hoe xAI deze telt, is essentieel om uw kosten onder controle te houden en uw dashboards correct te lezen.

Output
Gefactureerd tegen het output-tarief
usage
Gedetailleerd tracking-object
Separate
Reasoning apart van respons geteld
Effort
De hendel voor reasoning

Het usage-object in Chat Completions

Elk antwoord bevat een usage-object dat het verbruik specificeert. Hier is het voorbeeld uit de xAI Chat Completions API-referentie:

{
  "usage": {
    "prompt_tokens": 32,
    "completion_tokens": 9,
    "total_tokens": 135,
    "completion_tokens_details": {
      "reasoning_tokens": 94
    }
  }
}

In dit voorbeeld:

  • prompt_tokens (32): tokens in het invoerbericht
  • completion_tokens (9): tokens in de zichtbare respons
  • reasoning_tokens (94): tokens besteed aan interne reasoning
  • total_tokens (135): de som van alle drie, 32 + 9 + 94

Reasoning is dus niet opgenomen in completion_tokens: het wordt erbij opgeteld. Pas op als u komt van een andere API waar de conventie verschilt, of als uw dashboard de zichtbare respons berekent door aftrekking.

Reasoning-tokens uitlezen in code

In de Responses API draagt dezelfde informatie andere namen: input_tokens, output_tokens voor de zichtbare respons, en output_tokens_details.reasoning_tokens voor reasoning.

response = client.responses.create(
    model="grok-4.7",
    input="Solve the integral of x^2 * e^x dx.",
    reasoning={"effort": "high"},
)

visible_response = response.usage.output_tokens
reasoning = response.usage.output_tokens_details.reasoning_tokens
billed_output = visible_response + reasoning

print(f"Reasoning tokens: {reasoning}")
print(f"Response tokens: {visible_response}")
print(f"Reasoning share: {reasoning / billed_output * 100:.0f}%")

U stelt effort in op grok-4.7, grok-4.6 en grok-4.5; grok-4.20-0309-reasoning redeneert altijd, zonder effort-parameter.

Facturatie tegen het output-tarief

Reasoning-tokens worden gefactureerd tegen het tarief voor output-tokens, zoals het voorbeeld Reasoning Effort Evals in het xAI-kookboek ons herinnert. Voor grok-4.7 tegen $6 per miljoen output-tokens (prompt onder de 200.000 tokens) kost elk reasoning-token evenveel als een respons-token.

Effort weegt dus mee in de factuur, maar niet altijd zoveel als u misschien denkt. In ditzelfde voorbeeld verbruikten dertig korte supporttickets, afgehandeld door grok-4.7 met efforts medium, high en xhigh, ongeveer evenveel reasoning—rond de 600 tokens per respons—terwijl low ongeveer 140 verbruikte en de helft kostte, met scores allemaal tussen 87 en 93%. Meet dit op uw eigen data voordat u kiest.

Voorbeeld van kostenberekening

# grok-4.7: $6,00/M output-tokens (prompt < 200k)
cost_per_token = 6.00 / 1_000_000

reasoning = 600
visible_response = 350
billed_output = reasoning + visible_response  # 950

cost = billed_output * cost_per_token
print(f"Output cost: ${cost:.4f}")  # $0,0057

De rol van max_completion_tokens

De uitvoerlimiet—max_completion_tokens in Chat Completions, max_output_tokens in de Responses API—geldt alleen voor de zichtbare respons: volgens de API-referentie tellen reasoning-tokens en functieaanroepen hier niet voor mee. Zonder waarde is de standaard 128.000 tokens. Om reasoning te beperken, moet u effort instellen (les 10).

{
  "model": "grok-4.7",
  "messages": [
    {"role": "user", "content": "Explain special relativity."}
  ],
  "reasoning_effort": "medium",
  "max_completion_tokens": 2000
}

Prijzen geverifieerd op 3 november 2026—prijzen wijzigen regelmatig: controleer voor elke budgetberekening de actuele tarievenlijst op de officiële xAI-pagina voor modellen en prijzen.

Belangrijkste punten

  • Reasoning-tokens staan in usage.completion_tokens_details.reasoning_tokens (Chat Completions) of usage.output_tokens_details.reasoning_tokens (Responses)
  • Bij xAI tellen completion_tokens en output_tokens alleen de zichtbare respons; het totaal telt invoer, respons en reasoning op
  • Reasoning-tokens worden gefactureerd tegen het output-tarief
  • De uitvoerlimiet beperkt alleen de zichtbare respons; effort stuurt reasoning
  • Het kostenverschil tussen efforts hangt af van de taak: meet dit op uw eigen data