API de Limites de Taxa

A API de Limites de Taxa fornece acesso programático aos "rate limits" (limites de taxa) configurados para sua organização e seus workspaces. Estas são as mesmas informações exibidas na página Limits no Claude Console.

Use esta API para:

• Manter gateways e proxies sincronizados: Leia seus limites atuais na inicialização e em intervalos programados, em vez de codificar valores fixos que ficam desatualizados quando a Anthropic os ajusta.
• Alimentar alertas internos: Compare dados de uso da API de Uso e Custo com seus limites configurados.
• Auditar a configuração de workspaces: Verifique se as substituições de workspace correspondem ao que sua automação de provisionamento espera.

Início rápido

Liste os limites de taxa configurados para sua organização:

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

Limites de taxa da organização

O endpoint /v1/organizations/rate_limits retorna os limites de taxa aplicados no nível da organização para a Messages API e seus recursos de suporte. Limites para outros produtos, como Claude Managed Agents, não estão incluídos.

Conceitos principais

• Grupos de limites de taxa: Cada entrada na resposta representa um grupo de limites de taxa. Os limites de taxa de modelos são agrupados de forma que várias versões de modelo compartilhem um único conjunto de limites, e outros grupos cobrem recursos como a Message Batches API, a Files API, a Token Counting API, agent skills e a ferramenta de busca na web.
• group_type: Identifica qual categoria de limites a entrada cobre. Consulte Filtrando por tipo de grupo para a lista de valores.
• Lista models: Para entradas model_group, o campo models lista todos os IDs e aliases de modelo que contam para os limites desse grupo. Use essa lista para descobrir em qual grupo qualquer string de modelo se enquadra. Para outros tipos de grupo, models é null.
• Lista limits: Cada grupo contém uma lista de pares {type, value}. O campo type identifica o limitador (como requests_per_minute, input_tokens_per_minute ou output_tokens_per_minute) e value é o limite configurado. Consulte Limites de taxa para saber como cada limitador é medido e aplicado.

Para detalhes completos de parâmetros e esquemas de resposta, consulte a referência da API de Limites de Taxa da Organização.

Listar todos os limites de taxa da organização

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
}

Consultar os limites de um modelo específico

Passe qualquer ID ou alias de modelo como o parâmetro de consulta model para retornar apenas a entrada que o contém:

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"

Se a string do modelo não corresponder a nenhum grupo, o endpoint retorna um erro 404. O parâmetro model é suportado apenas no endpoint da organização; o endpoint de workspace não o aceita.

Limites de taxa de workspace

O endpoint /v1/organizations/workspaces/{workspace_id}/rate_limits retorna as substituições de limites de taxa configuradas para um único workspace.

A resposta inclui apenas substituições, então qualquer coisa ausente dela é herdada da organização:

• Um grupo ausente de data não tem nenhuma substituição de workspace. O workspace herda os limites de nível de organização para esse grupo (ele não é ilimitado).
• Dentro de um grupo presente, um tipo de limitador ausente de limits[] não tem substituição de workspace para esse limitador. O workspace herda o valor da organização para ele.
• Para cada limitador presente, org_limit é o valor de nível de organização para o mesmo limitador, ou null se a organização não tiver um limite configurado para esse tipo de limitador.

Para detalhes completos de parâmetros e esquemas de resposta, consulte a referência da API de Limites de Taxa de Workspace.

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
}

Filtrando por tipo de grupo

Ambos os endpoints aceitam um parâmetro de consulta opcional group_type que restringe a resposta a uma única categoria:

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"

Os valores válidos são model_group, batch, token_count, files, skills e web_search.

Paginação

Ambos os endpoints aceitam um parâmetro de consulta page e retornam um campo next_page. Atualmente, as respostas são sempre uma única página, então next_page é null. Itere sobre next_page para que seu cliente pagine corretamente sem alterações quando a resposta crescer.

Perguntas frequentes

Quais strings de modelo aparecem na lista models?

Todos os IDs e aliases de modelo que contam para o grupo, incluindo IDs com data (como claude-sonnet-4-5-20250929) e aliases sem data (como claude-sonnet-4-5). Procure qualquer string de modelo que você passa para a Messages API e você a encontrará em exatamente uma entrada model_group.

O que significa se um grupo está ausente da resposta de workspace?

O workspace não tem substituição para esse grupo e herda o limite de nível de organização. Consulte o endpoint da organização para ver os valores herdados.

Posso atualizar limites de taxa com esta API?

Não. Para definir limites de taxa de workspace, abra o workspace no Claude Console e use a aba Limits.

Veja também

• Limites de taxa
• Admin API
• Referência da Admin API
• Workspaces
• API de Uso e Custo