Ir al contenido principal
Español— Elegir un idioma
Menú

Recuento de tokens de razonamiento

Lección 8 de 12 Actualizado el 3 de noviembre de 2026 Desarrollador
En esta página
  1. Comprende los tokens de razonamiento
  2. El objeto usage en Chat Completions
  3. Accede a los tokens de razonamiento en el código
  4. Facturación a la tarifa de salida
  5. El papel de max_completion_tokens
  6. Puntos clave para recordar

Lección reescrita el 3 de noviembre de 2026 basándose en la referencia de la API de xAI (Chat Completions y Responses), la guía de Reasoning y el ejemplo de Reasoning Effort Evals del libro de recetas: en xAI, completion_tokens (o output_tokens) cuenta solo la respuesta visible, el razonamiento se cuenta por separado y el total suma los tres; el límite de salida no restringe el razonamiento. La versión anterior afirmaba lo contrario, utilizaba campos de Chat Completions en una respuesta de la API Responses, configuraba el esfuerzo en grok-4.20-0309-reasoning, que no lo acepta, y mostraba una captura de pantalla que no coincidía con la API; estos elementos se han corregido o eliminado. Fuentes: Chat Completions · Responses · Reasoning Effort Evals.

Comprende los tokens de razonamiento

Los modelos de razonamiento generan dos tipos de tokens: los destinados a la respuesta visible y los correspondientes al proceso de pensamiento interno del modelo. Entender cómo los cuenta xAI es esencial para dominar tus costes y leer correctamente tus paneles de control.

Salida
Facturada a la tarifa de salida
usage
Objeto de seguimiento detallado
Separado
Razonamiento contado fuera de la respuesta
Esfuerzo
La palanca del razonamiento

El objeto usage en Chat Completions

Cada respuesta incluye un objeto usage que detalla el consumo. Aquí tienes el ejemplo de la referencia de la API Chat Completions de xAI:

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

En este ejemplo:

  • prompt_tokens (32): tokens en el mensaje de entrada
  • completion_tokens (9): tokens en la respuesta visible
  • reasoning_tokens (94): tokens dedicados al razonamiento interno
  • total_tokens (135): la suma de los tres, 32 + 9 + 94

Por tanto, el razonamiento no se incluye en completion_tokens: se suma a este. Ten cuidado si vienes de otra API donde la convención difiere, o si tu panel de control calcula la respuesta visible por sustracción.

Accede a los tokens de razonamiento en el código

En la API Responses, la misma información recibe nombres distintos: input_tokens, output_tokens para la respuesta visible, y output_tokens_details.reasoning_tokens para el razonamiento.

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"Tokens de razonamiento: {reasoning}")
print(f"Tokens de respuesta: {visible_response}")
print(f"Porcentaje de razonamiento: {reasoning / billed_output * 100:.0f}%")

Configuras el esfuerzo en grok-4.7, grok-4.6 y grok-4.5; grok-4.20-0309-reasoning razona siempre, sin parámetro de esfuerzo.

Facturación a la tarifa de salida

Los tokens de razonamiento se facturan a la tarifa de tokens de salida, como nos recuerda el ejemplo de Reasoning Effort Evals en el libro de recetas de xAI. Para grok-4.7 a 6 $ por millón de tokens de salida (prompt inferior a 200.000 tokens), cada token de razonamiento cuesta lo mismo que un token de respuesta.

El esfuerzo, por tanto, repercute en la factura, pero no siempre tanto como podrías imaginar. En este mismo ejemplo, en treinta tickets de soporte breves gestionados por grok-4.7, los esfuerzos medium, high y xhigh consumieron aproximadamente la misma cantidad de razonamiento —unos 600 tokens por respuesta—, mientras que low consumió unos 140 y costó la mitad, con puntuaciones todas ellas entre el 87 % y el 93 %. Mide con tus propios datos antes de elegir.

Ejemplo de cálculo de costes

# grok-4.7: 6,00 $/M tokens de salida (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"Coste de salida: ${cost:.4f}")  # $0,0057

El papel de max_completion_tokens

El límite de salida —max_completion_tokens en Chat Completions, max_output_tokens en la API Responses— se aplica solo a la respuesta visible: según la referencia de la API, los tokens de razonamiento y las llamadas a funciones no cuentan para este límite. Sin un valor definido, el predeterminado es de 128.000 tokens. Para limitar el razonamiento, necesitas configurar el esfuerzo (lección 10).

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

Precios verificados el 3 de noviembre de 2026: los precios cambian con regularidad; antes de cualquier cálculo presupuestario, consulta la tarifa actualizada en la página oficial de modelos y precios de xAI.

Puntos clave para recordar

  • Los tokens de razonamiento están en usage.completion_tokens_details.reasoning_tokens (Chat Completions) o usage.output_tokens_details.reasoning_tokens (Responses)
  • En xAI, completion_tokens y output_tokens cuentan solo la respuesta visible; el total suma entrada, respuesta y razonamiento
  • Los tokens de razonamiento se facturan a la tarifa de salida
  • El límite de salida restringe solo la respuesta visible; el esfuerzo controla el razonamiento
  • La diferencia de coste entre esfuerzos depende de la tarea: mídela con tus propios datos