Aantal reasoning-tokens tellen
Op deze pagina
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(ofoutput_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 opgrok-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.
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) ofusage.output_tokens_details.reasoning_tokens(Responses) - Bij xAI tellen
completion_tokensenoutput_tokensalleen 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