---
title: Límites de velocidad
url: https://platform.claude.com/docs/es/api/rate-limits
description: Para mitigar el uso indebido y gestionar la capacidad de la API, existen límites sobre cuánto puede usar una organización la Claude API.
---
**[Claude Platform on AWS](https://platform.claude.com/docs/es/build-with-claude/claude-platform-on-aws):** Los límites de velocidad de esta página se aplican a Claude Platform on AWS, pero la facturación y la gestión de límites son diferentes. La facturación se realiza a través de AWS Marketplace (no mediante compras de créditos de Anthropic). Las organizaciones en Claude Platform on AWS se ubican en el nivel Start y pueden pasar automáticamente a un nivel superior a medida que acumulan un historial de facturas pagadas de AWS Marketplace. Para solicitar límites más altos, contacta a tu representante de cuenta de Anthropic o al [soporte de Anthropic](https://support.claude.com); el flujo **Request tier increase** no está disponible. La configuración de límites de velocidad por espacio de trabajo y el [modo rápido](https://platform.claude.com/docs/es/build-with-claude/fast-mode) no están disponibles en Claude Platform on AWS. Para más detalles, consulta [Límites de velocidad y cuotas en Claude Platform on AWS](https://platform.claude.com/docs/es/build-with-claude/claude-platform-on-aws#rate-limits-and-quotas).
Existen dos tipos de límites:
1. Los **límites de gasto** establecen un costo mensual máximo en el que una organización puede incurrir por el uso de la API.
2. Los **"rate limits" (límites de velocidad)** establecen el número máximo de solicitudes a la API que una organización puede realizar durante un período de tiempo definido.
La API aplica límites configurados por el servicio a nivel de organización, pero también puedes establecer límites configurables por el usuario para los espacios de trabajo de tu organización.
## Acerca de los límites de velocidad
* Los límites están diseñados para prevenir el abuso de la API, minimizando al mismo tiempo el impacto en los patrones de uso comunes de los clientes.
* Los límites se definen por **nivel de uso**. Las organizaciones se ubican en un nivel automáticamente según su historial de uso y el estado de su cuenta, y pueden pasar a un nivel superior con el tiempo a medida que usan la API.
* Las organizaciones nuevas y las organizaciones con un historial de uso limitado pueden comenzar en el nivel Evaluation, con límites inferiores a los límites estándar que se muestran en esta página mientras se establece el historial de la cuenta. Estos límites iniciales forman parte de cómo Anthropic previene el fraude y el abuso, y aumentan automáticamente a medida que tu organización acumula historial de uso.
* Los límites se establecen a nivel de organización. Puedes ver el nivel de tu organización y sus límites actuales en la página [Límites de velocidad](https://platform.claude.com/usage/limits) (`platform.claude.com/usage/limits`) de la [Claude Console](https://platform.claude.com/).
* Es posible que alcances los límites de velocidad en intervalos de tiempo más cortos. Por ejemplo, una tasa de 60 solicitudes por minuto (RPM) podría aplicarse como 1 solicitud por segundo. Las ráfagas cortas de solicitudes pueden exceder el límite y provocar errores de límite de velocidad.
* Los siguientes límites son los límites estándar para cada nivel. Si necesitas límites más altos, consulta [Solicitar límites más altos](https://platform.claude.com/docs/es/api/rate-limits#requesting-higher-limits).
* La API utiliza el [algoritmo de token bucket](https://en.wikipedia.org/wiki/Token_bucket) para aplicar los límites de velocidad. Esto significa que tu capacidad se repone continuamente hasta tu límite máximo, en lugar de restablecerse en intervalos fijos.
* Todos los límites descritos aquí representan el uso máximo permitido, no mínimos garantizados. Estos límites tienen como objetivo reducir el gasto excesivo no intencional y garantizar una distribución justa de los recursos entre los usuarios.
## Límites de gasto
**[Claude Platform en AWS](https://platform.claude.com/docs/es/build-with-claude/claude-platform-on-aws):** Se aplican los mismos topes de gasto mensual, y las solicitudes se detienen al alcanzar el tope de la misma manera. La facturación y los aumentos de nivel funcionan de forma diferente; consulta [Límites de gasto en Claude Platform en AWS](https://platform.claude.com/docs/es/build-with-claude/claude-platform-on-aws#spend-limits).
Cada uno de los niveles Start, Build y Scale tiene un tope de gasto mensual, que es lo máximo que tu organización puede gastar en la API cada mes calendario. Puedes ver el tope de gasto mensual de tu organización y establecer tu propio límite en la página [Facturación](https://platform.claude.com/settings/billing) de la Claude Console.
| Nivel de uso | Tope de gasto mensual |
| ------------ | --------------------- |
| Start | $500 USD |
| Build | $1,000 USD |
| Scale | $200,000 USD |
Las organizaciones en el nivel Custom no tienen tope de gasto mensual; los límites se acuerdan con su equipo de cuenta.
### Alcanzar tu tope de gasto
Una vez que alcanzas el tope de gasto de tu nivel, el uso de la API se pausa hasta las 00:00 UTC del primer día del mes siguiente, a menos que solicites un límite más alto antes. Mientras el uso está pausado, las solicitudes a la API devuelven HTTP 429:
```json
{
"type": "error",
"error": {
"type": "rate_limit_error",
"message": "You have reached your API usage limits: your organization has crossed its monthly API usage threshold, set based on your organization's API tier. You will regain access on 2026-09-01 at 00:00 UTC.",
"details": { "error_code": "enforced_spend_limit_reached" }
},
"request_id": "req_018EeWyXxfu5pfWkrYcMdjWG"
}
```
* El tipo de error es `rate_limit_error`, el mismo que para un límite de velocidad, pero la respuesta no incluye el encabezado `retry-after`. Los reintentos, incluidos los reintentos automáticos del SDK, fallan hasta que se restablece el acceso.
* En la Messages API, `error.details.error_code` es `enforced_spend_limit_reached`. Úsalo para distinguir esta respuesta de un límite de velocidad.
* Pasar a un nivel superior restablece el acceso; consulta [Solicitar límites más altos](https://platform.claude.com/docs/es/api/rate-limits#requesting-higher-limits).
### Establecer tu propio límite de gasto
También puedes establecer tu propio límite de gasto por debajo del tope de tu nivel para controlar los costos:
En la Claude Console, ve a la página [Facturación](https://platform.claude.com/settings/billing) (`platform.claude.com/settings/billing`).
En la sección **Spend limits**, haz clic en **Adjust limit** (o **Set limit** si actualmente no hay ningún límite establecido).
Ingresa un nuevo valor. Tu límite de gasto no puede exceder el tope de tu nivel actual.
Cuando el uso alcanza un límite de gasto que estableciste, las solicitudes devuelven HTTP 400 con el tipo de error `invalid_request_error`. El mensaje comienza con `You have reached your specified API usage limits`, o `You have reached your specified workspace API usage limits` para un límite de espacio de trabajo, e indica cuándo se reanuda el acceso. Aumenta o elimina el límite para restaurar el acceso antes.
Los límites del [espacio de trabajo de Claude Code](https://platform.claude.com/docs/es/manage-claude/workspaces#claude-code-workspace) se verifican por separado: las solicitudes de Claude Code que superen el límite de ese espacio de trabajo pueden recibir en su lugar un 429 que incluye un encabezado `retry-after`.
## Límites de velocidad
Los límites de velocidad para la Messages API se miden en solicitudes por minuto (RPM), tokens de entrada por minuto (ITPM) y tokens de salida por minuto (OTPM) para cada clase de modelo. Si excedes cualquiera de los límites de velocidad, recibirás un [error 429](https://platform.claude.com/docs/es/api/errors) que describe qué límite de velocidad se excedió. Cuando la respuesta incluya un encabezado `retry-after`, espera ese número de segundos antes de reintentar.
También podrías encontrar errores 429 debido a los límites de aceleración de la API si tu organización tiene un aumento brusco en el uso. Para evitar alcanzar los límites de aceleración, incrementa tu tráfico gradualmente y mantén patrones de uso consistentes.
### ITPM con reconocimiento de caché
Muchos proveedores de API usan un límite combinado de "tokens per minute" (tokens por minuto), o TPM, que puede incluir todos los tokens, tanto en caché como sin caché, de entrada y de salida. **Para la mayoría de los modelos de Claude, solo los tokens de entrada sin caché cuentan para tus límites de velocidad de ITPM.** Esta es una ventaja clave que hace que los límites de velocidad sean efectivamente más altos de lo que podrían parecer inicialmente.
Los límites de velocidad de ITPM se estiman al comienzo de cada solicitud, y la estimación se ajusta durante la solicitud para reflejar el número real de tokens de entrada utilizados.
Esto es lo que cuenta para ITPM:
* `input_tokens` (tokens después del último punto de interrupción de caché) ✓ **Cuentan para ITPM**
* `cache_creation_input_tokens` (tokens que se escriben en la caché) ✓ **Cuentan para ITPM**
* `cache_read_input_tokens` (tokens leídos de la caché) ✗ **NO cuentan para ITPM** en la mayoría de los modelos
El campo `input_tokens` solo representa los tokens que aparecen **después de tu último punto de interrupción de caché**, no todos los tokens de entrada de tu solicitud. Para calcular el total de tokens de entrada:
```text wrap
total_input_tokens = cache_read_input_tokens + cache_creation_input_tokens + input_tokens
```
Esto significa que, cuando tienes contenido en caché, `input_tokens` normalmente será mucho menor que tu entrada total. Por ejemplo, con un documento en caché de 200k tokens y una pregunta del usuario de 50 tokens, verías `input_tokens: 50` aunque la entrada total sea de 200,050 tokens.
Para efectos de los límites de velocidad en la mayoría de los modelos, solo `input_tokens` + `cache_creation_input_tokens` cuentan para tu límite de ITPM, lo que convierte al ["prompt caching" (almacenamiento en caché de prompts)](https://platform.claude.com/docs/es/build-with-claude/prompt-caching) en una forma eficaz de aumentar tu rendimiento efectivo.
**Ejemplo:** Con un límite de 2,000,000 ITPM y una tasa de aciertos de caché del 80%, podrías procesar efectivamente 10,000,000 tokens de entrada totales por minuto (2M sin caché + 8M en caché), porque los tokens en caché no cuentan para tu límite de velocidad.
Claude Haiku 3.5 (marcado con la nota al pie 4 en las siguientes tablas de límites de velocidad) también cuenta `cache_read_input_tokens` para los límites de velocidad de ITPM.
Para todos los demás modelos, los tokens de entrada en caché no cuentan para los límites de velocidad y se facturan a la [tarifa de lectura de caché](https://platform.claude.com/docs/es/build-with-claude/prompt-caching#pricing), una fracción del precio base de entrada. Esto significa que puedes lograr un rendimiento efectivo significativamente mayor usando el [almacenamiento en caché de prompts](https://platform.claude.com/docs/es/build-with-claude/prompt-caching).
Para aprovechar al máximo tus límites de velocidad, almacena en caché el contenido repetido, como instrucciones del sistema y prompts, documentos de contexto extensos, definiciones de herramientas e historial de conversación; consulta [almacenamiento en caché de prompts](https://platform.claude.com/docs/es/build-with-claude/prompt-caching) para obtener orientación. Con un almacenamiento en caché eficaz, puedes aumentar sustancialmente tu rendimiento real sin elevar tus límites de velocidad. Supervisa tu tasa de aciertos de caché en la [página de Uso](https://platform.claude.com/usage) de la Claude Console para ajustar tu estrategia de almacenamiento en caché.
Los límites de velocidad de OTPM se evalúan en tiempo real a medida que se producen los tokens de salida, contando solo los tokens realmente generados. El parámetro `max_tokens` no se tiene en cuenta en los cálculos del límite de velocidad de OTPM, por lo que no hay ninguna desventaja en cuanto a límites de velocidad al establecer un valor de `max_tokens` más alto.
Cada fila de las siguientes tablas tiene sus propios límites de RPM, ITPM y OTPM. Algunas filas abarcan varios modelos que comparten un mismo límite; consulta las notas al pie de las tablas. Puedes consultar tus límites de velocidad actuales y su comportamiento en la página [Límites de velocidad](https://platform.claude.com/usage/limits) de la Claude Console, o leer los límites configurados de forma programática con la [Rate Limits API](https://platform.claude.com/docs/es/manage-claude/rate-limits-api).
Actualmente, los límites de velocidad se comparten entre todos los valores de `inference_geo`. Las solicitudes con `inference_geo: "us"` e `inference_geo: "global"` consumen del mismo grupo de límites de velocidad.
| Modelo | Máximo de solicitudes por minuto (RPM) | Máximo de tokens de entrada por minuto (ITPM) | Máximo de tokens de salida por minuto (OTPM) |
| --------------------------------------------------------------------------------------------------------------------------- | -------------------------------------- | --------------------------------------------- | -------------------------------------------- |
| Claude Fable 5.x1 | 1,000 | 500,000 | 100,000 |
| Claude Opus 5.5 | 1,000 | 2,000,000 | 400,000 |
| Claude Opus 5 | 1,000 | 2,000,000 | 400,000 |
| Claude Opus 4.x2 | 1,000 | 2,000,000 | 400,000 |
| Claude Sonnet 5.5 | 1,000 | 2,000,000 | 400,000 |
| Claude Sonnet 5 | 1,000 | 2,000,000 | 400,000 |
| Claude Sonnet 4.x3 | 1,000 | 2,000,000 | 400,000 |
| Claude Haiku 5.5 | 1,000 | 2,000,000 | 400,000 |
| Claude Haiku 4.5 | 1,000 | 2,000,000 | 400,000 |
| Claude Haiku 3.5 ([retirado, excepto en Google Cloud](https://platform.claude.com/docs/es/about-claude/model-deprecations)) | 1,000 | 100,0004 | 20,000 |
| Modelo | Máximo de solicitudes por minuto (RPM) | Máximo de tokens de entrada por minuto (ITPM) | Máximo de tokens de salida por minuto (OTPM) |
| --------------------------------------------------------------------------------------------------------------------------- | -------------------------------------- | --------------------------------------------- | -------------------------------------------- |
| Claude Fable 5.x1 | 2,000 | 1,500,000 | 300,000 |
| Claude Opus 5.5 | 5,000 | 5,000,000 | 1,000,000 |
| Claude Opus 5 | 5,000 | 5,000,000 | 1,000,000 |
| Claude Opus 4.x2 | 5,000 | 5,000,000 | 1,000,000 |
| Claude Sonnet 5.5 | 5,000 | 5,000,000 | 1,000,000 |
| Claude Sonnet 5 | 5,000 | 5,000,000 | 1,000,000 |
| Claude Sonnet 4.x3 | 5,000 | 5,000,000 | 1,000,000 |
| Claude Haiku 5.5 | 5,000 | 5,000,000 | 1,000,000 |
| Claude Haiku 4.5 | 5,000 | 5,000,000 | 1,000,000 |
| Claude Haiku 3.5 ([retirado, excepto en Google Cloud](https://platform.claude.com/docs/es/about-claude/model-deprecations)) | 2,000 | 200,0004 | 40,000 |
| Modelo | Máximo de solicitudes por minuto (RPM) | Máximo de tokens de entrada por minuto (ITPM) | Máximo de tokens de salida por minuto (OTPM) |
| --------------------------------------------------------------------------------------------------------------------------- | -------------------------------------- | --------------------------------------------- | -------------------------------------------- |
| Claude Fable 5.x1 | 4,000 | 4,000,000 | 800,000 |
| Claude Opus 5.5 | 10,000 | 10,000,000 | 2,000,000 |
| Claude Opus 5 | 10,000 | 10,000,000 | 2,000,000 |
| Claude Opus 4.x2 | 10,000 | 10,000,000 | 2,000,000 |
| Claude Sonnet 5.5 | 10,000 | 10,000,000 | 2,000,000 |
| Claude Sonnet 5 | 10,000 | 10,000,000 | 2,000,000 |
| Claude Sonnet 4.x3 | 10,000 | 10,000,000 | 2,000,000 |
| Claude Haiku 5.5 | 10,000 | 10,000,000 | 2,000,000 |
| Claude Haiku 4.5 | 10,000 | 10,000,000 | 2,000,000 |
| Claude Haiku 3.5 ([retirado, excepto en Google Cloud](https://platform.claude.com/docs/es/about-claude/model-deprecations)) | 4,000 | 400,0004 | 80,000 |
Si necesitas límites superiores a los del nivel Scale, contacta al equipo de ventas a través de la página [Límites de velocidad](https://platform.claude.com/usage/limits) de la Claude Console.
*1 El límite de velocidad de Fable es un límite total que se aplica al tráfico combinado de Claude Fable 5.1 y Claude Fable 5. Claude Mythos 5.1 y Claude Mythos 5 comparten un límite combinado independiente en los mismos términos.*
*2 El límite de velocidad de Opus es un límite total que se aplica al tráfico combinado de Claude Opus 4.8, Opus 4.7, Opus 4.6 y Opus 4.5. Claude Opus 5.5 y Claude Opus 5 tienen cada uno un límite de velocidad independiente y no forman parte de este grupo combinado.*
*3 El límite de velocidad de Sonnet 4.x es un límite total que se aplica al tráfico combinado de Sonnet 4.6 y Sonnet 4.5 ([obsoleto](https://platform.claude.com/docs/es/about-claude/model-deprecations)). Claude Sonnet 5.5 y Claude Sonnet 5 tienen cada uno un límite de velocidad independiente y no forman parte de este grupo combinado.*
*4 El límite cuenta `cache_read_input_tokens` para el uso de ITPM.*
### Message Batches API
La Message Batches API tiene su propio conjunto de límites de velocidad, que se comparten entre todos los modelos. Estos incluyen un límite de solicitudes por minuto (RPM) para todos los endpoints de la API y un límite en el número de solicitudes de lote que pueden estar en la cola de procesamiento al mismo tiempo. Una "solicitud de lote" aquí se refiere a una parte de un Message Batch. Puedes crear un Message Batch que contenga miles de solicitudes de lote, cada una de las cuales cuenta para este límite. Una solicitud de lote se considera parte de la cola de procesamiento cuando aún no ha sido procesada exitosamente por el modelo.
| Máximo de solicitudes por minuto (RPM) | Máximo de solicitudes de lote en la cola de procesamiento | Máximo de solicitudes de lote por lote |
| -------------------------------------- | --------------------------------------------------------- | -------------------------------------- |
| 1,000 | 200,000 | 100,000 |
| Máximo de solicitudes por minuto (RPM) | Máximo de solicitudes de lote en la cola de procesamiento | Máximo de solicitudes de lote por lote |
| -------------------------------------- | --------------------------------------------------------- | -------------------------------------- |
| 2,000 | 300,000 | 100,000 |
| Máximo de solicitudes por minuto (RPM) | Máximo de solicitudes de lote en la cola de procesamiento | Máximo de solicitudes de lote por lote |
| -------------------------------------- | --------------------------------------------------------- | -------------------------------------- |
| 4,000 | 500,000 | 100,000 |
Si necesitas límites superiores a los del nivel Scale, contacta al equipo de ventas a través de la página [Límites de velocidad](https://platform.claude.com/usage/limits) de la Claude Console.
### Managed Agents
Los endpoints de [Claude Managed Agents](https://platform.claude.com/docs/es/managed-agents/overview) tienen límites de velocidad por organización. Estos límites son independientes de los límites de velocidad de la Messages API anteriores.
| Operación | Límite |
| ----------------------------------------------------------------------- | ---------------------------- |
| Endpoints de creación (por ejemplo, agentes, sesiones y entornos) | 300 solicitudes por minuto |
| Endpoints de lectura (por ejemplo, recuperar, listar y hacer streaming) | 1,200 solicitudes por minuto |
### Files API
Las solicitudes a la [Files API](https://platform.claude.com/docs/es/build-with-claude/files) tienen su propio límite por organización, compartido entre las operaciones de carga, listado, recuperación, descarga y eliminación, e independiente de los límites de la Messages API descritos anteriormente en esta página. Consulta [Límites de velocidad de la Files API](https://platform.claude.com/docs/es/build-with-claude/files#rate-limits) para conocer el valor actual.
### Límites de velocidad del modo rápido
Cuando usas el [modo rápido](https://platform.claude.com/docs/es/build-with-claude/fast-mode) con `speed: "fast"` en Claude Opus 5.5, Claude Opus 5 o Claude Opus 4.8, se aplican límites de velocidad dedicados que son independientes de los límites de velocidad estándar de Opus. Claude Opus 5.5 tiene un límite de velocidad predeterminado para el modo rápido en los niveles Start, Build y Scale, por lo que no necesitas solicitar acceso para usar el modo rápido con él. Las organizaciones en el nivel Evaluation pueden usar el modo rápido con Claude Opus 5.5 una vez que pasen al nivel Start, Build o Scale. El modo rápido para Claude Opus 5 y Claude Opus 4.8 está en vista previa de investigación. Para ver tus límites de velocidad del modo rápido, ve a la página [Límites de velocidad](https://platform.claude.com/usage/limits) de la Claude Console. Cuando se superan los límites de velocidad del modo rápido, la API devuelve un error `429` con un encabezado `retry-after`.
La respuesta incluye encabezados `anthropic-fast-*` que indican el estado de tu límite de velocidad del modo rápido. Consulta [Límites de velocidad del modo rápido](https://platform.claude.com/docs/es/build-with-claude/fast-mode#rate-limits) para obtener detalles sobre estos encabezados.
### Monitorear tus límites de velocidad en la Console
Puedes monitorear el uso de tus límites de velocidad en la página [Uso](https://platform.claude.com/usage) de la [Claude Console](https://platform.claude.com/).
Además de proporcionar gráficos de tokens y solicitudes, la página de Uso ofrece dos gráficos de límites de velocidad separados. Usa estos gráficos para ver qué margen tienes para crecer, identificar cuándo podrías estar alcanzando el uso máximo, entender qué límites de velocidad solicitar y aprender cómo mejorar tus tasas de almacenamiento en caché. Los gráficos visualizan varias métricas para un límite de velocidad determinado (por ejemplo, por modelo):
* El gráfico **Rate Limit - Input Tokens** (Límite de velocidad - Tokens de entrada) incluye:
* Máximo por hora de tokens de entrada sin caché por minuto
* Tu límite de velocidad actual de tokens de entrada por minuto
* La tasa de caché de tus tokens de entrada (es decir, el porcentaje de tokens de entrada leídos desde la caché)
* El gráfico **Rate Limit - Output Tokens** (Límite de velocidad - Tokens de salida) incluye:
* Máximo por hora de tokens de salida por minuto
* Tu límite de velocidad actual de tokens de salida por minuto
## Solicitar límites más altos
Para solicitar límites de velocidad más altos o un tope de gasto mensual más alto, usa **Request tier increase** en la página [Límites de velocidad](https://platform.claude.com/usage/limits) de la Claude Console. El soporte de Anthropic también puede aumentar los límites; para necesidades urgentes, contacta al [soporte de Anthropic](https://support.claude.com).
**[Claude Platform on AWS](https://platform.claude.com/docs/es/build-with-claude/claude-platform-on-aws):** El flujo **Request tier increase** no está disponible. Contacta a tu representante de cuenta de Anthropic o al [soporte de Anthropic](https://support.claude.com), e incluye los modelos cuyos límites necesitas aumentar, tus picos de tokens de entrada y salida por minuto para cada modelo, y aproximadamente qué proporción de tu entrada es contexto en caché o repetido. Consulta [Límites de velocidad y cuotas en Claude Platform on AWS](https://platform.claude.com/docs/es/build-with-claude/claude-platform-on-aws#rate-limits-and-quotas).
## Establecer límites más bajos para los espacios de trabajo
Para más información sobre los espacios de trabajo, consulta [Espacios de trabajo](https://platform.claude.com/docs/es/manage-claude/workspaces).
Para proteger los espacios de trabajo de tu organización de un posible uso excesivo, puedes establecer límites de gasto y de velocidad personalizados por espacio de trabajo.
Ejemplo: Si el límite de tu organización es de 40,000 tokens de entrada por minuto y 8,000 tokens de salida por minuto, podrías limitar un espacio de trabajo a 30,000 tokens de entrada por minuto. Esto protege a los demás espacios de trabajo de un posible uso excesivo y garantiza una distribución más equitativa de los recursos en toda tu organización. Los tokens por minuto restantes no utilizados (o más, si ese espacio de trabajo no usa el límite) quedan entonces disponibles para que los usen otros espacios de trabajo.
Nota:
* No puedes establecer límites en el espacio de trabajo predeterminado.
* Si no se establecen, los límites del espacio de trabajo coinciden con el límite de la organización.
* Los límites del espacio de trabajo se establecen por tipo de limitador (como solicitudes por minuto, tokens de entrada por minuto o tokens de salida por minuto).
* Los límites de toda la organización siempre se aplican, incluso si los límites de los espacios de trabajo suman más.
Para leer de forma programática los límites de velocidad actuales de tu organización y de tus espacios de trabajo, usa la [Rate Limits API](https://platform.claude.com/docs/es/manage-claude/rate-limits-api).
## Encabezados de respuesta
La respuesta de la API incluye encabezados que te muestran el límite de velocidad aplicado, el uso actual y cuándo se restablecerá el límite.
Se devuelven los siguientes encabezados:
| Encabezado | Descripción |
| --------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `retry-after` | El número de segundos que debes esperar hasta poder reintentar la solicitud. Los reintentos anteriores fallarán. No todos los 429 lo incluyen; el 429 del tope de gasto nunca lo incluye (consulta [Alcanzar tu tope de gasto](https://platform.claude.com/docs/es/api/rate-limits#reaching-your-spend-cap)). |
| `anthropic-ratelimit-requests-limit` | El número máximo de solicitudes permitidas dentro de cualquier período de límite de velocidad. |
| `anthropic-ratelimit-requests-remaining` | El número de solicitudes restantes antes de que se aplique el límite de velocidad. |
| `anthropic-ratelimit-requests-reset` | El momento en que el límite de velocidad de solicitudes se repondrá por completo, proporcionado en formato RFC 3339. |
| `anthropic-ratelimit-tokens-limit` | El número máximo de tokens permitidos dentro de cualquier período de límite de velocidad. |
| `anthropic-ratelimit-tokens-remaining` | El número de tokens restantes (redondeado al millar más cercano) antes de que se aplique el límite de velocidad. |
| `anthropic-ratelimit-tokens-reset` | El momento en que el límite de velocidad de tokens se repondrá por completo, proporcionado en formato RFC 3339. |
| `anthropic-ratelimit-input-tokens-limit` | El número máximo de tokens de entrada permitidos dentro de cualquier período de límite de velocidad. |
| `anthropic-ratelimit-input-tokens-remaining` | El número de tokens de entrada restantes (redondeado al millar más cercano) antes de que se aplique el límite de velocidad. |
| `anthropic-ratelimit-input-tokens-reset` | El momento en que el límite de velocidad de tokens de entrada se repondrá por completo, proporcionado en formato RFC 3339. |
| `anthropic-ratelimit-output-tokens-limit` | El número máximo de tokens de salida permitidos dentro de cualquier período de límite de velocidad. |
| `anthropic-ratelimit-output-tokens-remaining` | El número de tokens de salida restantes (redondeado al millar más cercano) antes de que se aplique el límite de velocidad. |
| `anthropic-ratelimit-output-tokens-reset` | El momento en que el límite de velocidad de tokens de salida se repondrá por completo, proporcionado en formato RFC 3339. |
| `anthropic-priority-input-tokens-limit` | El número máximo de tokens de entrada de Priority Tier permitidos dentro de cualquier período de límite de velocidad. (Solo Priority Tier) |
| `anthropic-priority-input-tokens-remaining` | El número de tokens de entrada de Priority Tier restantes (redondeado al millar más cercano) antes de que se aplique el límite de velocidad. (Solo Priority Tier) |
| `anthropic-priority-input-tokens-reset` | El momento en que el límite de velocidad de tokens de entrada de Priority Tier se repondrá por completo, proporcionado en formato RFC 3339. (Solo Priority Tier) |
| `anthropic-priority-output-tokens-limit` | El número máximo de tokens de salida de Priority Tier permitidos dentro de cualquier período de límite de velocidad. (Solo Priority Tier) |
| `anthropic-priority-output-tokens-remaining` | El número de tokens de salida de Priority Tier restantes (redondeado al millar más cercano) antes de que se aplique el límite de velocidad. (Solo Priority Tier) |
| `anthropic-priority-output-tokens-reset` | El momento en que el límite de velocidad de tokens de salida de Priority Tier se repondrá por completo, proporcionado en formato RFC 3339. (Solo Priority Tier) |
Los encabezados `anthropic-ratelimit-tokens-*` muestran los valores del límite más restrictivo actualmente en vigor. Por ejemplo, si has excedido el límite de tokens por minuto del espacio de trabajo, los encabezados contendrán los valores del límite de velocidad de tokens por minuto del espacio de trabajo. Si no se aplican límites de espacio de trabajo, los encabezados devolverán el total de tokens restantes, donde el total es la suma de los tokens de entrada y de salida. Este enfoque garantiza que tengas visibilidad de la restricción más relevante sobre tu uso actual de la API. Para ver contra qué espacio de trabajo se contabilizó una solicitud, lee el [encabezado de respuesta](https://platform.claude.com/docs/es/api/overview#response-headers) `anthropic-workspace-id`, que contiene el ID del espacio de trabajo al que se resolvió tu clave de API o token de acceso.