# Calculadora de límite de tasa de la API: tokens y peticiones por minuto

> Calcula cuántas peticiones por minuto, hora y día permite tu límite de tokens (ITPM, OTPM) y de peticiones (RPM), y cuál te frena primero.

- Calculadora gratis y sin registro: https://skilio.com/calculadoras/limite-tasa-api-tokens-por-minuto-peticiones/
- Sirve en cualquier país (eliges la moneda).

## 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.

## Qué datos pide

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

- Tu nivel de uso: Start
- Modelo: Opus 5.5, Sonnet 5.5 o Haiku 5.5
- Tokens de entrada por petición: 2.000 tokens
- Tokens de salida por petición: 500 tokens
- Parte de la entrada que sale de caché: 0 %

Según el modo que elijas, también:

- Peticiones por minuto (RPM): 4.000
- Tokens de entrada por minuto (ITPM): 2.000.000
- Tokens de salida por minuto (OTPM): 400.000

## Resultado con los valores de ejemplo

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

- Peticiones por minuto: 800
- Por hora: 48.000
- Por día: 1.152.000

## ¿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](https://platform.claude.com/docs/en/api/rate-limits).

## Cómo usar la calculadora

1. **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.
2. **Modelo:** los modelos se agrupan por límites iguales. Fable 5.x tiene los más bajos; Opus, Sonnet y Haiku `5.5` comparten los suyos; los modelos 5 y 4.x, otros.
3. **Tokens de entrada y de salida:** lo que gasta cada petición. Si no lo sabes, mira el campo `usage` de una respuesta real.
4. **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.
