API de Rate Limits

La API de Rate Limits proporciona acceso programático a los "rate limits" (límites de velocidad) configurados para tu organización y sus espacios de trabajo. Esta es la misma información que se muestra en la página de Límites en la Claude Console.

Usa esta API para:

• Mantener gateways y proxies sincronizados: Lee tus límites actuales al inicio y de forma programada en lugar de codificar valores fijos que se desactualizan cuando Anthropic los ajusta.
• Impulsar alertas internas: Compara los datos de uso de la API de Uso y Costos con tus límites configurados.
• Auditar la configuración de espacios de trabajo: Verifica que las anulaciones de los espacios de trabajo coincidan con lo que espera tu automatización de aprovisionamiento.



Inicio rápido

Lista los límites de velocidad configurados para tu organización:

curl "https://api.anthropic.com/v1/organizations/rate_limits" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"



Límites de velocidad de la organización

El endpoint /v1/organizations/rate_limits devuelve los límites de velocidad aplicados a nivel de organización para la Messages API y sus recursos de soporte. Los límites de otros productos, como Claude Managed Agents, no están incluidos.



Conceptos clave

• Grupos de límites de velocidad: Cada entrada en la respuesta representa un grupo de límites de velocidad. Los límites de velocidad de los modelos están agrupados de modo que varias versiones de modelos comparten un único conjunto de límites, y otros grupos cubren recursos como la Message Batches API, la Files API, la Token Counting API, las habilidades de agente y la herramienta de búsqueda web.
• group_type: Identifica qué categoría de límites cubre la entrada. Consulta Filtrar por tipo de grupo para ver la lista de valores.
• Lista models: Para las entradas model_group, el campo models lista cada ID de modelo y alias que cuenta contra los límites de ese grupo. Usa esta lista para buscar a qué grupo pertenece cualquier cadena de modelo. Para otros tipos de grupo, models es null.
• Lista limits: Cada grupo contiene una lista de pares {type, value}. El campo type identifica el limitador (como requests_per_minute, input_tokens_per_minute u output_tokens_per_minute) y value es el límite configurado. Consulta Límites de velocidad para saber cómo se mide y se aplica cada limitador.

Para obtener detalles completos de los parámetros y los esquemas de respuesta, consulta la referencia de la API de Organization Rate Limits.



Listar todos los límites de velocidad de la organización

curl "https://api.anthropic.com/v1/organizations/rate_limits" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

{
  "data": [
    {
      "type": "rate_limit",
      "group_type": "model_group",
      "models": ["claude-opus-5"],
      "limits": [
        { "type": "requests_per_minute", "value": 4000 },
        { "type": "input_tokens_per_minute", "value": 10000000 },
        { "type": "output_tokens_per_minute", "value": 800000 }
      ]
    },
    {
      "type": "rate_limit",
      "group_type": "model_group",
      "models": [
        "claude-opus-4-5",
        "claude-opus-4-5-20251101",
        "claude-opus-4-6",
        "claude-opus-4-7",
        "claude-opus-4-8"
      ],
      "limits": [
        { "type": "requests_per_minute", "value": 4000 },
        { "type": "input_tokens_per_minute", "value": 10000000 },
        { "type": "output_tokens_per_minute", "value": 800000 }
      ]
    },
    {
      "type": "rate_limit",
      "group_type": "batch",
      "models": null,
      "limits": [{ "type": "enqueued_batch_requests", "value": 500000 }]
    }
  ],
  "next_page": null
}



Buscar los límites de un modelo específico

Pasa cualquier ID de modelo o alias como el parámetro de consulta model para devolver solo la entrada que lo contiene:

curl "https://api.anthropic.com/v1/organizations/rate_limits?model=claude-opus-5" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

Si la cadena del modelo no coincide con ningún grupo, el endpoint devuelve un error 404. El parámetro model solo es compatible con el endpoint de organización; el endpoint de espacio de trabajo no lo acepta.



Límites de velocidad de espacios de trabajo

El endpoint /v1/organizations/workspaces/{workspace_id}/rate_limits devuelve las anulaciones de límites de velocidad configuradas para un único espacio de trabajo.

La respuesta solo incluye anulaciones, por lo que cualquier cosa que falte en ella se hereda de la organización:

• Un grupo que está ausente de data no tiene ninguna anulación de espacio de trabajo. El espacio de trabajo hereda los límites a nivel de organización para ese grupo (no es ilimitado).
• Dentro de un grupo que está presente, un tipo de limitador que está ausente de limits[] no tiene anulación de espacio de trabajo para ese limitador. El espacio de trabajo hereda el valor de la organización para él.
• Para cada limitador que está presente, org_limit es el valor a nivel de organización para el mismo limitador, o null si la organización no tiene un límite configurado para ese tipo de limitador.

Para obtener detalles completos de los parámetros y los esquemas de respuesta, consulta la referencia de la API de Workspace Rate Limits.

curl "https://api.anthropic.com/v1/organizations/workspaces/wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ/rate_limits" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

{
  "data": [
    {
      "type": "workspace_rate_limit",
      "group_type": "model_group",
      "models": ["claude-opus-5"],
      "limits": [
        { "type": "requests_per_minute", "value": 1000, "org_limit": 4000 },
        { "type": "input_tokens_per_minute", "value": 500000, "org_limit": 10000000 }
      ]
    },
    {
      "type": "workspace_rate_limit",
      "group_type": "model_group",
      "models": [
        "claude-opus-4-5",
        "claude-opus-4-5-20251101",
        "claude-opus-4-6",
        "claude-opus-4-7",
        "claude-opus-4-8"
      ],
      "limits": [
        { "type": "requests_per_minute", "value": 1000, "org_limit": 4000 },
        { "type": "input_tokens_per_minute", "value": 500000, "org_limit": 10000000 }
      ]
    }
  ],
  "next_page": null
}



Filtrar por tipo de grupo

Ambos endpoints aceptan un parámetro de consulta opcional group_type que restringe la respuesta a una sola categoría:

curl "https://api.anthropic.com/v1/organizations/rate_limits?group_type=batch" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ANTHROPIC_ADMIN_KEY"

Los valores válidos son model_group, batch, token_count, files, skills y web_search.



Paginación

Ambos endpoints aceptan un parámetro de consulta page y devuelven un campo next_page. Actualmente las respuestas son siempre una sola página, por lo que next_page es null. Itera sobre next_page para que tu cliente pagine correctamente sin cambios cuando la respuesta crezca.



Preguntas frecuentes



¿Qué cadenas de modelo aparecen en la lista models?

Cada ID de modelo y alias que cuenta contra el grupo, incluyendo IDs con fecha (como claude-sonnet-4-5-20250929) y alias sin fecha (como claude-sonnet-4-5). Busca cualquier cadena de modelo que pases a la Messages API y la encontrarás en exactamente una entrada model_group.



¿Qué significa si un grupo falta en la respuesta del espacio de trabajo?

El espacio de trabajo no tiene anulación para ese grupo y hereda el límite a nivel de organización. Consulta el endpoint de organización para ver los valores heredados.



¿Puedo actualizar los límites de velocidad con esta API?

No. Para establecer los límites de velocidad de un espacio de trabajo, abre el espacio de trabajo en la Claude Console y usa la pestaña Limits.



Ver también

• Límites de velocidad
• Admin API
• Referencia de la Admin API
• Espacios de trabajo
• API de Uso y Costos