En resumen
- En Claude Sonnet 5.5, Opus 5.5, Fable 5.1 y Haiku 5.5 el prompt debe tener al menos 512 tokens para usar la caché; con menos, la petición se procesa sin caché y no da error.
- Con Sonnet 5.5, un prefijo de 3,000 tokens y 30 llamadas por hora, la entrada baja de 0.18 a 0.0162 dólares por hora: ahorras 0.1638 dólares, un 91 %.
- En otros modelos el mínimo sube: 1,024 tokens en Opus 4.8, Sonnet 5 y Sonnet 4.6, 2,048 en Opus 4.7 y 4,096 en Opus 4.6, Opus 4.5 y Haiku 4.5.
- Escribir en la caché cuesta 1.25 veces la entrada (5 minutos) o 2 veces (1 hora); leerla cuesta 0.05 veces en Sonnet 5.5 y Opus 5.5, 0.025 en Fable 5.1 y 0.10 en el resto.
¿Cuántos tokens mínimos necesita la caché del prompt de Claude?
En Claude Sonnet 5.5, Opus 5.5, Fable 5.1 y Haiku 5.5, el prefijo que quieres cachear necesita al menos 512 tokens. Con menos, la API no usa la caché, aunque la pidas, y tampoco te avisa con un error. En modelos anteriores el mínimo es mayor: 1,024, 2,048 o 4,096 tokens.
Esta calculadora te dice si tu prefijo llega al mínimo, cuántos tokens te faltan y, si llega, cuánto ahorras por llamada y por hora.
Mínimo por modelo
Estos son los mínimos de la documentación oficial de caché del prompt de Anthropic:
| Modelo | Mínimo de tokens |
|---|---|
| Claude Fable 5.1, Opus 5.5, Sonnet 5.5 y Haiku 5.5 | 512 |
| Claude Opus 4.8, Sonnet 5 y Sonnet 4.6 | 1,024 |
| Claude Opus 4.7 | 2,048 |
| Claude Opus 4.6, Opus 4.5 y Haiku 4.5 | 4,096 |
Los mínimos son iguales en todas las plataformas donde está el modelo. Si tu prompt se queda justo por debajo, suele merecer la pena añadir contenido útil hasta llegar: leer de la caché es mucho más barato que enviar la entrada normal.
Cómo comprobar si se usó la caché
La respuesta de la API trae dos campos de uso: cache_creation_input_tokens y cache_read_input_tokens. Si los dos valen 0, el prompt no se cacheó. La causa más probable es que no llegaba al mínimo.
Cuándo compensa: escritura y lectura
La caché no es gratis de escribir. Los multiplicadores sobre el precio de entrada son:
- Escribir con duración de 5 minutos: 1.25 veces.
- Escribir con duración de 1 hora: 2 veces.
- Leer: 0.10 veces en general, 0.05 en Sonnet 5.5 y Opus 5.5, y 0.025 en Fable 5.1.
La primera llamada paga la escritura, que es más cara que la entrada normal. Las siguientes leen a precio bajo y renuevan la caché. Si pasa más tiempo que la duración entre dos llamadas, la caché caduca y la siguiente vuelve a pagar la escritura.
Cómo se calcula
cacheable = tokens del prefijo ≥ mínimo del modelo sin caché por hora = llamadas × prefijo × precio de entrada con caché por hora = escritura + (llamadas − 1) × lectura
- Los precios son por millón de tokens, así que cada producto se divide entre 1,000,000.
- El intervalo entre llamadas es 60 entre las llamadas por hora, en minutos. Si supera la duración de la caché, se paga la escritura en cada llamada.
- Haiku 5.5 cobra más cuando el prompt pasa de 100,000 tokens: la calculadora lo aplica sola.
- Los precios de entrada son de la página oficial de precios: 10 dólares por millón en Fable 5.1, 4 en Opus 5.5, 2 en Sonnet 5.5 y 0.10 en Haiku 5.5 (0.50 si el prompt pasa de 100,000 tokens).
Cómo usar la calculadora
- Modelo. Elige uno de Claude. Si no está, elige «Otro modelo» y escribe su mínimo y su precio en las opciones avanzadas.
- Tokens del prefijo fijo. Lo que va igual al principio de cada llamada: instrucciones, herramientas, documentos o ejemplos.
- Llamadas por hora. Cuántas veces envías ese prefijo, repartidas más o menos por igual.
En las opciones avanzadas puedes elegir 1 hora de duración. Es útil si hay pocas llamadas por hora.
Ejemplo
Un asistente con Claude Sonnet 5.5 tiene un prefijo de 3,000 tokens y recibe 30 llamadas por hora, con caché de 5 minutos:
| Concepto | Resultado |
|---|---|
| ¿Llega al mínimo de 512 tokens? | Sí |
| Entrada por hora sin caché | $0.18 |
| Entrada por hora con caché | $0.0162 |
| Ahorro por hora | $0.1638 |
| Ahorro por llamada | $0.0055 |
La entrada baja un 91 %: de cada 100 dólares de entrada, ahorras unos 91. Con 1 hora de duración y las mismas 30 llamadas, el ahorro sería parecido, porque ya llegan llamadas más seguido que cada 5 minutos.
Con solo 10 llamadas por hora, llega una cada 6 minutos. La caché de 5 minutos caduca entre llamadas y cuesta unos 0.015 dólares más por hora. Con 1 hora de duración, en cambio, ahorras unos 0.0453 dólares por hora.
Preguntas frecuentes
¿Qué pasa si mi prompt no llega al mínimo?
La petición funciona igual, pero sin caché y sin error. Pagas la entrada normal. Revisa los campos de uso de la respuesta para confirmarlo.
¿Cuántas llamadas necesito para que compense?
Dentro de la misma ventana de la caché, con 5 minutos compensa desde la 2.ª llamada; con 1 hora, desde la 3.ª. Una sola llamada no compensa, porque escribir cuesta más que la entrada normal.
¿El mínimo cuenta todo el prompt o solo la parte cacheada?
Cuenta la parte que quieres cachear: el prefijo hasta el punto donde marcas la caché. Si ese prefijo es más corto que el mínimo, no se cachea.
¿Por qué mi caché no ahorra con pocas llamadas por hora?
Porque entre una llamada y otra pasa más tiempo que la duración de la caché. Cada llamada vuelve a escribirla a un precio mayor que la entrada normal. Prueba con 1 hora de duración.
¿Puedo usar la calculadora con un modelo que no sale en la lista?
Sí. Elige «Otro modelo» y escribe en las opciones avanzadas su mínimo, su precio de entrada y cuánto cuesta leer la caché.
Son estimaciones: los mínimos y los precios pueden cambiar, así que contrástalos con la documentación oficial de Anthropic.