# Calculadora del coste de las herramientas en la API de IA: tokens extra por llamada

> Calcula los tokens extra que añaden las definiciones de herramientas a cada llamada de la API y lo que cuestan al mes según el modelo.

- Calculadora gratis y sin registro: https://skilio.com/calculadoras/coste-ia-sobrecarga-tokens-definiciones-herramientas-por-llamada/
- Sirve en cualquier país (eliges la moneda).

## En resumen

- Con 5 herramientas de 300 tokens cada una, cada llamada lleva 1,786 tokens extra: 1,500 de definiciones y 286 del prompt de sistema de herramientas.
- Con 1,000 llamadas al día durante 30 días son 53,580,000 tokens, unos $107.16 al mes con Claude Sonnet 5.5 a $2 por millón.
- Con Claude Opus 5.5 ($4 por millón) el mismo uso cuesta $214.32 al mes; con Claude Haiku 5.5 ($0.10), $5.36.
- Forzar el uso de una herramienta (any o tool) sube el prompt de sistema de 286 a 406 tokens por llamada.

## Qué datos pide

Etiqueta del campo y valor de ejemplo con el que se abre la calculadora:

- Modelo: Claude Sonnet 5.5
- Herramientas que envías en cada llamada: 5 herramientas
- Llamadas a la API al día: 1,000
- Tokens por definición de herramienta: 300 tokens
- Días de uso al mes: 30
- Elección de herramienta: auto o none
- Herramientas integradas de Anthropic: Ninguna
- Resto de la entrada por llamada: 2,000 tokens
- Llamadas con las herramientas leídas de la caché: 0 %

## Resultado con los valores de ejemplo

Es lo que da la calculadora con los datos de ejemplo de la lista anterior:

- Tokens extra por llamada: 1,786
- Coste extra al mes: $107.16

## ¿Cuántos tokens añaden las herramientas a cada llamada?

Cada llamada con herramientas añade las definiciones de todas ellas más un prompt de sistema fijo: 286 tokens con elección «auto» o «none» en Claude Opus 5.5, Sonnet 5.5 y Haiku 5.5, y 406 con «any» o «tool». Un token es un trozo de texto (unas tres cuartas partes de una palabra) y la API cobra por los que envías. Con 5 herramientas de 300 tokens, son 1,786 tokens extra por llamada.

Esta calculadora sirve para cualquier país. Los precios están en dólares y son los de la [página oficial de precios de Anthropic](https://platform.claude.com/docs/en/about-claude/pricing).

## Cómo usar la calculadora

- **Modelo:** elige Opus, Sonnet o Haiku. Cada uno tiene su precio de entrada por millón de tokens.
- **Herramientas:** cuántas funciones envías en cada llamada, aunque el modelo no use todas.
- **Llamadas al día:** cuántas veces llamas a la API.
- **Opciones avanzadas:** tokens por definición (estimación), días al mes, tipo de elección, herramientas integradas (bash suma 325 tokens y el editor de texto 974), el resto de la entrada y el porcentaje de llamadas con caché.

## Fórmula

```
tokens extra por llamada = herramientas × tokens por definición + prompt de sistema + integradas
tokens al mes = tokens extra por llamada × llamadas al día × días
coste al mes = tokens al mes ÷ 1,000,000 × precio por millón
```

El prompt de sistema es 286 o 406 tokens según la elección de herramienta. Si no envías ninguna herramienta, vale 0. La página oficial publica los 406 de «any» o «tool» para Haiku 5.5; para Opus 5.5 y Sonnet 5.5 no los detalla y la calculadora aplica la misma cifra como estimación.

## Ejemplo con los valores de la calculadora

| Dato | Resultado |
| --- | --- |
| Definiciones | 5 × 300 = 1,500 tokens |
| Prompt de sistema (auto) | 286 tokens |
| Extra por llamada | 1,786 tokens |
| Al mes (1,000 llamadas al día, 30 días) | 53,580,000 tokens |
| Coste con Claude Sonnet 5.5 | $107.16 |
| Coste con Claude Opus 5.5 | $214.32 |
| Coste con Claude Haiku 5.5 | $5.36 |

Cada 1,000 llamadas cuestan $3.57 solo por las herramientas. Si el resto de la entrada es de 2,000 tokens, 47 de cada 100 tokens de entrada son herramientas.

## Cómo reducir la sobrecarga

- Envía solo las herramientas que la tarea puede necesitar.
- Acorta las descripciones y los esquemas sin perder claridad.
- Usa la caché de prompts: las lecturas cuestan una fracción del precio normal ($0.10 por millón en Sonnet 5.5). Mira el [punto de equilibrio entre caché de 5 minutos y de 1 hora](https://skilio.com/calculadoras/coste-ia-cache-5-minutos-vs-1-hora-punto-equilibrio/).
- Usa un modelo más barato para lo sencillo y deja el caro para lo difícil: [cascada de modelos](https://skilio.com/calculadoras/coste-ia-cascada-modelo-barato-modelo-caro-porcentaje-escalado/).
- Para tareas que no urgen, compara el [nivel flex y el estándar](https://skilio.com/calculadoras/coste-ia-nivel-flex-vs-estandar-ahorro-tareas-no-urgentes/).

## Qué no incluye el cálculo

No cuenta los bloques tool_use y tool_result de la conversación, ni la salida del modelo, ni cargos de herramientas del lado del servidor, como la [ejecución de código](https://skilio.com/calculadoras/coste-ia-ejecucion-codigo-contenedor-horas-gratis-coste/). Haiku 5.5 se calcula con el precio de prompts de hasta 100,000 tokens ($0.10 por millón); por encima sube a $0.50. Si pruebas tus cambios, mira el [coste de una evaluación](https://skilio.com/calculadoras/coste-ia-evaluacion-pruebas-regresion-coste-por-ejecucion/). Es una estimación, no una factura.

## Preguntas frecuentes

### ¿Pago las herramientas aunque el modelo no las use?
Sí. Las definiciones van en la entrada de cada llamada donde las envíes, las use el modelo o no. Por eso conviene enviar solo las necesarias.

### ¿Cuántos tokens tiene una definición de herramienta?
Depende del nombre, la descripción y el esquema. Una función sencilla ronda los 100 tokens y una con muchos parámetros puede pasar de 500. La calculadora usa 300 como estimación editable.

### ¿Qué diferencia hay entre «auto» y «any»?
Con «auto» o «none», el prompt de sistema de herramientas es de 286 tokens. Con «any» o «tool», que obligan a usar una herramienta, sube a 406. Son 120 tokens más por llamada. Anthropic publica ese dato para Haiku 5.5; en los otros dos modelos es una estimación.

### ¿Cuánto añaden las herramientas bash y editor de texto?
La herramienta bash suma 325 tokens de entrada y el editor de texto 974, según la página oficial de precios. Se suman al prompt de sistema de herramientas.

### ¿La caché reduce este coste?
Sí. Si el bloque de herramientas se lee de la caché, se paga el precio de lectura: $0.10 por millón en Sonnet 5.5 en lugar de $2. Prueba con el campo de caché de las opciones avanzadas.