En resumen
- Con el nivel Start y un modelo de la familia Sonnet, peticiones de 2.000 tokens de entrada y 500 de salida llegan a 800 peticiones por minuto, unas 48.000 por hora.
- El límite que manda es el menor de tres: peticiones por minuto, tokens de entrada por minuto y tokens de salida por minuto; en ese ejemplo frena el de salida (400.000 entre 500).
- En la API de Claude, los tokens leídos de caché no cuentan para el límite de entrada: con un 80 % de caché, 2.000 de entrada pasan a contar 400.
- El límite se repone de forma continua (cubo de fichas), no se reinicia cada minuto; una ráfaga puede dar un error 429 aunque la media sea baja.
¿Cuántas peticiones por minuto permite mi límite de tokens?
Permite el menor de tres números: el límite de peticiones por minuto, el de tokens de entrada y el de tokens de salida, cada uno dividido entre lo que gasta tu petición. Con 2.000 tokens de entrada y 500 de salida, en el nivel Start de un modelo Sonnet 5.5, el máximo es de 800 peticiones por minuto.
Un token es un trozo de texto, más o menos tres cuartas partes de una palabra. La API mide cuántos envías y cuántos recibes. Cada límite se mide por minuto y por organización, no por persona. Esta calculadora usa los límites de la API de Claude, la documentación oficial está en platform.claude.com.
Cómo usar la calculadora
- Tu nivel de uso: Start, Build o Scale. Lo ves en la página de límites de tu consola. Cada nivel tiene límites más altos.
- Modelo: los modelos se agrupan por límites iguales. Fable 5.x tiene los más bajos; Opus, Sonnet y Haiku
5.5comparten los suyos; los modelos 5 y 4.x, otros. - Tokens de entrada y de salida: lo que gasta cada petición. Si no lo sabes, mira el campo
usagede una respuesta real. - Opciones avanzadas: la parte de entrada que sale de caché y tus propios límites, por si tu organización tiene otros.
Cómo se calcula
entrada que cuenta = entrada × (1 − caché ÷ 100) por peticiones = RPM por entrada = ITPM ÷ entrada que cuenta por salida = OTPM ÷ tokens de salida máximo por minuto = el menor de los tres, hacia abajo por hora = máximo × 60 por día = máximo × 1.440
RPM son las peticiones por minuto, ITPM los tokens de entrada por minuto y OTPM los de salida por minuto. El máximo se redondea hacia abajo porque no puedes enviar media petición. Es una regla de tres: si el límite son 400.000 tokens y cada petición gasta 500, caben 800 peticiones.
Ejemplo
Nivel Start, modelo Sonnet 5.5, 2.000 tokens de entrada y 500 de salida, sin caché:
| Límite | Tu límite | Peticiones por minuto |
|---|---|---|
| Peticiones (RPM) | 4.000 | 4.000 |
| Entrada (ITPM) | 2.000.000 | 1.000 |
| Salida (OTPM) | 400.000 | 800 |
Gana el menor, 800 peticiones por minuto: 48.000 por hora y 1.152.000 por día. A ese ritmo salen 13,3 peticiones por segundo y se generan 400.000 tokens de salida por minuto. Frena la salida: de cada 100 tokens que podrías gastar, los de salida se agotan primero.
La caché y el límite de entrada
En la API de Claude solo cuentan para el límite de entrada los tokens nuevos y los que se escriben en caché. Los tokens leídos de caché no cuentan. Con el 80 % de la entrada en caché, 2.000 tokens pasan a contar 400, y el límite de entrada permite 5.000 peticiones por minuto en lugar de 1.000.
El límite de salida se mide con los tokens realmente generados, no con el máximo que pidas. Para ir más rápido ahí solo ayuda acortar las respuestas o subir de nivel.
Qué hacer al recibir un error 429
Un error 429 significa que superaste algún límite. Si la respuesta trae la cabecera retry-after, espera esos segundos. La API repone la capacidad de forma continua, así que una ráfaga puede cortarte aunque la media por minuto sea baja: reparte las peticiones en el tiempo. Un ritmo de 60 por minuto puede aplicarse como 1 por segundo.
Hay otro caso distinto: el tope mensual de gasto de tu nivel. Al llegar a él, la API también responde 429, pero sin retry-after, y no vuelve hasta el primer día del mes siguiente.
Preguntas frecuentes
¿Cuántos tokens por minuto tengo?
Depende de tu nivel y de tu modelo. En Start con Sonnet 5.5, 2.000.000 de tokens de entrada y 400.000 de salida por minuto. Mira el tuyo en la página de límites de tu consola.
¿Cuál es la diferencia entre RPM, ITPM y OTPM?
RPM cuenta peticiones, ITPM tokens de entrada y OTPM tokens de salida. Se aplican a la vez: el primero que superes provoca el error 429.
¿Los tokens de caché cuentan para el límite?
Los leídos de caché no cuentan para el de entrada. Los que se escriben en caché sí.
¿Por qué me da error si mi media está por debajo?
El límite se aplica en intervalos más cortos que un minuto. Muchas peticiones juntas pueden superarlo aunque en un minuto completo no lleguen al máximo.
¿Los límites son por persona o por organización?
Por organización. Todas las claves y personas de la misma organización comparten el mismo límite.
¿Estos límites cambian?
Sí. Esta calculadora es una estimación con los límites estándar publicados; confírmalos en la documentación oficial y en tu consola.