Għadd ta' Tokens tar-Raġunar
F'din il-paġna
Lezzjon miktuba mill-ġdid fit-3 ta’ Novembru 2026 abbażi tar-referenza tal-API ta’ xAI (Chat Completions u Responses), il-gwida Reasoning, u l-eżempju Reasoning Effort Evals mill-cookbook: f’xAI,
completion_tokens(jewoutput_tokens) jgħodd biss ir-risposta viżibbli, ir-raġunar jingħadd separatament, u t-total iżid it-tlieta kollha; il-limitu tal-output ma jillimitax ir-raġunar. Il-verżjoni preċedenti kienet tgħid il-kuntrarju, użat oqsma ta’ Chat Completions fuq tweġiba tal-API Responses, issettjat l-isforz fuqgrok-4.20-0309-reasoningli ma jaċċettahx, u wriet screenshot li ma kienx jaqbel mal-API; dawn l-elementi ġew ikkoreġuti jew imneħħija. Sorsi: Chat Completions · Responses · Reasoning Effort Evals.
Ifhem it-tokens tar-raġunar
Il-mudelli tar-raġunar jipproduċu żewġ tipi ta’ tokens: dawk għar-risposta viżibbli, u dawk għall-proċess tal-ħsieb intern tal-mudell. Li tifhem kif xAI jgħoddhom huwa essenzjali biex timmaniġġja l-ispejjeż tiegħek u taqra d-dashboards tiegħek b’mod korrett.
L-oġġett usage f’Chat Completions
Kull tweġiba tinkludi oġġett usage li jiddettalja l-konsum. Hawnhekk hemm l-eżempju mir-referenza tal-API Chat Completions ta’ xAI:
{
"usage": {
"prompt_tokens": 32,
"completion_tokens": 9,
"total_tokens": 135,
"completion_tokens_details": {
"reasoning_tokens": 94
}
}
}
F’dan l-eżempju:
- prompt_tokens (32): tokens fil-messaġġ tal-input
- completion_tokens (9): tokens fir-risposta viżibbli
- reasoning_tokens (94): tokens iddedikati għar-raġunar intern
- total_tokens (135): is-somma tat-tlieta, 32 + 9 + 94
Għalhekk, ir-raġunar mhuwiex inkluż f’completion_tokens: jiġi miżjud miegħu. Oqgħod attent jekk ġej minn API oħra fejn il-konvenzjoni hija differenti, jew jekk id-dashboard tiegħek jikkalkula r-risposta viżibbli permezz ta’ tnaqqis.
Aċċessa t-tokens tar-raġunar fil-kodiċi
Fl-API Responses, l-istess informazzjoni ġġib ismijiet differenti: input_tokens, output_tokens għar-risposta viżibbli, u output_tokens_details.reasoning_tokens għar-raġunar.
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}%")
Tissettja l-isforz fuq grok-4.7, grok-4.6, u grok-4.5; grok-4.20-0309-reasoning dejjem jirraġuna, mingħajr parametru ta’ sforz.
Fatturazzjoni bir-rata tal-output
It-tokens tar-raġunar jiġu ffallurati bir-rata tat-tokens tal-output, kif ifakkarna l-eżempju Reasoning Effort Evals fil-cookbook ta’ xAI. Għal grok-4.7 bi $6 għal kull miljun token tal-output (prompt taħt 200,000 token), kull token tar-raġunar jiswi l-istess bħal token tar-risposta.
Għalhekk l-isforz jiżen fuq il-kont, iżda mhux dejjem daqs kemm tista’ timmaġina. F’dan l-istess eżempju, fuq tletin ticket ta’ appoġġ qasir immaniġġjati minn grok-4.7, l-isforzi medium, high, u xhigh ikkonsumaw ammont simili ta’ raġunar—madwar 600 token għal kull tweġiba—filwaqt li low ikkonsuma madwar 140 u nefaq nofs il-flus, b’punteġġi kollha bejn 87 u 93%. Kejjel fuq id-data tiegħek stess qabel ma tagħżel.
Eżempju ta’ kalkolu tal-ispiża
# 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
Ir-rwol ta’ max_completion_tokens
Il-kapp tal-output—max_completion_tokens f’Chat Completions, max_output_tokens fl-API Responses—japplika biss għar-risposta viżibbli: skont ir-referenza tal-API, it-tokens tar-raġunar u s-sejħiet tal-funzjonijiet ma jgħoddux għalih. Mingħajr valur, jiddefawltja għal 128,000 token. Biex tillimita r-raġunar, trid tissettja l-isforz (lezzjoni 10).
{
"model": "grok-4.7",
"messages": [
{"role": "user", "content": "Explain special relativity."}
],
"reasoning_effort": "medium",
"max_completion_tokens": 2000
}
Prezzijiet ivverifikati fit-3 ta’ Novembru 2026—il-prezzijiet jinbidlu regolarment: qabel kwalunkwe kalkolu tal-baġit, iċċekkja l-karta tar-rati attwali fuq il-paġna uffiċjali tal-mudelli u l-prezzijiet ta’ xAI.
Punti Ewlenin
- It-tokens tar-raġunar jinsabu f’
usage.completion_tokens_details.reasoning_tokens(Chat Completions) jewusage.output_tokens_details.reasoning_tokens(Responses) - F’xAI,
completion_tokensuoutput_tokensjgħoddu biss ir-risposta viżibbli; it-total iżid l-input, ir-risposta, u r-raġunar - It-tokens tar-raġunar jiġu ffallurati bir-rata tal-output
- Il-kapp tal-output jillimita biss ir-risposta viżibbli; l-isforz jikkontrolla r-raġunar
- Id-differenza fl-ispiża bejn l-isforzi tiddependi mill-kompitu: kejjilha fuq id-data tiegħek stess