Costes y facturación de las herramientas
En esta página
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