Aqbeż għall-kontenut ewlieni
Malti— Agħżel lingwa
Menu

Għadd ta' Tokens tar-Raġunar

Lezzjoni 8 / 12 Aġġornat 3 ta’ Novembru 2026 Zviluppatur
F'din il-paġna
  1. Ifhem it-tokens tar-raġunar
  2. L-oġġett usage f’Chat Completions
  3. Aċċessa t-tokens tar-raġunar fil-kodiċi
  4. Fatturazzjoni bir-rata tal-output
  5. Ir-rwol ta’ max_completion_tokens
  6. Punti Ewlenin

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 (jew output_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 fuq grok-4.20-0309-reasoning li 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.

Output
Iffatturat bir-rata tal-output
usage
Oġġett ta' traċċar dettaljat
Separat
Ir-raġunar jingħadd barra r-risposta
Effort
Il-leva fuq ir-raġunar

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) jew usage.output_tokens_details.reasoning_tokens (Responses)
  • F’xAI, completion_tokens u output_tokens jgħ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