API de Límites de Velocidad

La API de Límites de Velocidad 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 Limits de Claude Console.

Usa esta API para:

• Mantener sincronizados los gateways y proxies: Lee tus límites actuales al inicio y de forma periódica en lugar de codificar valores fijos que quedan desactualizados cuando Anthropic los ajusta.
• Potenciar 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. No se incluyen los límites de otros productos, como Claude Managed Agents.

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 se agrupan 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 Filtrado por tipo de grupo para ver la lista de valores.
• Lista models: Para las entradas de tipo model_group, el campo models lista cada ID y alias de modelo que cuenta para 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 , o ) y es el límite configurado. Consulta para ver cómo se mide y aplica cada limitador.

Para obtener detalles completos de los parámetros y esquemas de respuesta, consulta la referencia de la API de Límites de Velocidad de la Organización.

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-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 o alias de modelo como 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-4-8" \
  --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 se admite en el endpoint de la organización; el endpoint del espacio de trabajo no lo acepta.

Límites de velocidad del espacio 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 todo lo 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 esquemas de respuesta, consulta la referencia de la API de Límites de Velocidad del Espacio de Trabajo.

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-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
}

Filtrado 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 siempre constan de una sola página, por lo que next_page es null. Itera sobre next_page para que tu cliente pagine correctamente sin necesidad de cambios cuando la respuesta crezca.

Preguntas frecuentes

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

Cada ID y alias de modelo que cuenta para el grupo, incluidos los IDs con fecha (como claude-sonnet-4-5-20250929) y los 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 de tipo 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 la organización para ver los valores heredados.

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

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

Consulta también

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