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

Costes y facturación de las herramientas

Lección 3 de 16 Actualizado el 30 de julio de 2026 Desarrollador
En esta página
  1. Comprensión de la facturación de las herramientas de Grok
  2. Estructura de facturación en dos partes
  3. Escenarios de coste acumulado
  4. Estrategias de optimización de costes
  5. Comparación con los SDK
  6. Puntos clave

Comprensión de la facturación de las herramientas de Grok

El uso de las herramientas integradas en la API de Grok genera costes adicionales más allá del consumo estándar de tokens. Comprender esta estructura de facturación es esencial para prever tus gastos y optimizar tu integración.

Estructura de facturación en dos partes

Cada llamada a una herramienta se factura de dos formas:

1. Consumo de tokens

Las herramientas consumen tokens como cualquier otra interacción con el modelo. Los tokens de entrada incluyen tu prompt, las definiciones de las herramientas y el contexto de la conversación. Los tokens de salida incluyen la respuesta del modelo y los resultados de la herramienta.

Los resultados de búsqueda (web o X) añaden un volumen significativo de tokens de entrada, ya que el modelo recibe extractos de las páginas o publicaciones encontradas. Cuantos más numerosos o detallados sean los resultados, mayor será el consumo de tokens.

2. Coste por invocación

Además de los tokens, cada llamada a una herramienta se factura a una tarifa fija de 5 $ por cada 1.000 invocaciones, es decir, 0,005 $ por llamada. Esta tarifa es idéntica para las tres herramientas principales:

  • Búsqueda web: 0,005 $ por búsqueda
  • Búsqueda en X: 0,005 $ por búsqueda
  • Ejecución de código: 0,005 $ por ejecución

Este coste se factura por cada llamada a la herramienta, independientemente del número de resultados devueltos o de la complejidad de la ejecución.

Escenarios de coste acumulado

El modelo puede realizar múltiples llamadas a herramientas para una única solicitud del usuario. Estos son los escenarios más comunes:

Solicitud sencilla (1 llamada)

Un usuario pide las últimas noticias sobre un tema concreto. El modelo realiza una única búsqueda web. Coste adicional: 0,005 $ + tokens por los resultados.

Solicitud compleja (múltiples llamadas)

Un usuario solicita un análisis comparativo que requiere datos web y un cálculo. El modelo realiza una búsqueda web y luego usa la Ejecución de código para procesar los datos. Coste adicional: 0,010 $ + tokens por ambos resultados.

Solicitud iterativa (llamadas sucesivas)

El modelo considera que los resultados iniciales son insuficientes y refina su búsqueda con una segunda llamada web. Coste adicional: 0,010 $ por ambas búsquedas.

Estrategias de optimización de costes

Sé preciso en tus prompts

Un prompt ambiguo lleva al modelo a realizar múltiples búsquedas para cubrir diferentes interpretaciones posibles. Un prompt preciso reduce el número de llamadas.

Habilita solo las herramientas necesarias

Si tu caso de uso requiere solo búsqueda web, no añadas la Búsqueda en X ni la Ejecución de código al array tools. El modelo podría usarlas innecesariamente.

Usa filtrado por dominio

Para la Búsqueda web, los parámetros allowed_domains y excluded_domains limitan el alcance de la búsqueda. Unos resultados más específicos implican menos iteraciones.

Supervisa tu uso

La consola de xAI te permite seguir tus costes en tiempo real. Configura alertas de facturación para evitar gastos excesivos, especialmente durante la fase de desarrollo, cuando las pruebas pueden acumularse.

Comparación con los SDK

La facturación es idéntica independientemente del SDK que utilices (xAI SDK, OpenAI SDK, Vercel AI SDK o cURL directo). Los costes dependen únicamente del número de invocaciones y de los tokens consumidos, no del método de acceso.

Puntos clave

  • La facturación combina tokens (consumo estándar) e invocaciones (0,005 $ por llamada)
  • La tarifa es uniforme: 5 $ por 1.000 llamadas, independientemente de la herramienta
  • El modelo puede realizar múltiples llamadas por solicitud, multiplicando los costes
  • Los prompts precisos y el filtrado adecuado reducen las llamadas innecesarias
  • La consola de xAI te permite supervisar el consumo en tiempo real