Rate Limits API

Rate Limits API предоставляет программный доступ к ограничениям скорости (rate limits), настроенным для вашей организации и её рабочих пространств. Это та же информация, которая отображается на странице Limits в Claude Console.

Используйте этот API, чтобы:

• Поддерживать синхронизацию шлюзов и прокси: Считывайте ваши текущие лимиты при запуске и по расписанию вместо жёсткого кодирования значений, которые устаревают, когда Anthropic их корректирует.
• Обеспечивать работу внутренних оповещений: Сравнивайте данные об использовании из Usage and Cost API с вашими настроенными лимитами.
• Проводить аудит конфигурации рабочих пространств: Проверяйте, что переопределения рабочих пространств соответствуют тому, что ожидает ваша автоматизация подготовки.



Быстрый старт

Получите список ограничений скорости, настроенных для вашей организации:

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



Ограничения скорости организации

Конечная точка /v1/organizations/rate_limits возвращает ограничения скорости, применяемые на уровне организации для Messages API и поддерживающих его ресурсов. Лимиты для других продуктов, таких как Claude Managed Agents, не включены.



Ключевые понятия

• Группы ограничений скорости: Каждая запись в ответе представляет одну группу ограничений скорости. Ограничения скорости моделей сгруппированы так, что несколько версий моделей используют один набор лимитов, а другие группы охватывают такие ресурсы, как Message Batches API, Files API, Token Counting API, навыки агентов и инструмент веб-поиска.
• group_type: Определяет, какую категорию лимитов охватывает запись. Список значений см. в разделе Фильтрация по типу группы.
• Список models: Для записей model_group поле models перечисляет каждый идентификатор модели и псевдоним, которые учитываются в лимитах этой группы. Используйте этот список, чтобы определить, к какой группе относится любая строка модели. Для других типов групп models равно null.
• Список limits: Каждая группа содержит список пар {type, value}. Поле type определяет ограничитель (например, requests_per_minute, input_tokens_per_minute или output_tokens_per_minute), а value — это настроенный лимит. См. Ограничения скорости, чтобы узнать, как измеряется и применяется каждый ограничитель.

Полные сведения о параметрах и схемы ответов см. в справочнике Organization Rate Limits API.



Список всех ограничений скорости организации

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
}



Поиск лимитов для конкретной модели

Передайте любой идентификатор модели или псевдоним в качестве параметра запроса model, чтобы вернуть только запись, которая его содержит:

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"

Если строка модели не соответствует ни одной группе, конечная точка возвращает ошибку 404. Параметр model поддерживается только на конечной точке организации; конечная точка рабочего пространства его не принимает.



Ограничения скорости рабочего пространства

Конечная точка /v1/organizations/workspaces/{workspace_id}/rate_limits возвращает переопределения ограничений скорости, настроенные для отдельного рабочего пространства.

Ответ включает только переопределения, поэтому всё, что в нём отсутствует, наследуется от организации:

• Группа, отсутствующая в data, вообще не имеет переопределения на уровне рабочего пространства. Рабочее пространство наследует лимиты уровня организации для этой группы (она не является неограниченной).
• Внутри присутствующей группы тип ограничителя, отсутствующий в limits[], не имеет переопределения рабочего пространства для этого ограничителя. Рабочее пространство наследует для него значение организации.
• Для каждого присутствующего ограничителя org_limit — это значение уровня организации для того же ограничителя, или null, если у организации нет настроенного лимита для этого типа ограничителя.

Полные сведения о параметрах и схемы ответов см. в справочнике Workspace Rate Limits API.

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
}



Фильтрация по типу группы

Обе конечные точки принимают необязательный параметр запроса group_type, который ограничивает ответ одной категорией:

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"

Допустимые значения: model_group, batch, token_count, files, skills и web_search.



Пагинация

Обе конечные точки принимают параметр запроса page и возвращают поле next_page. В настоящее время ответы всегда состоят из одной страницы, поэтому next_page равно null. Выполняйте цикл по next_page, чтобы ваш клиент корректно выполнял пагинацию без изменений, когда ответ увеличится.



Часто задаваемые вопросы



Какие строки моделей появляются в списке models?

Каждый идентификатор модели и псевдоним, которые учитываются в группе, включая датированные идентификаторы (такие как claude-sonnet-4-5-20250929) и недатированные псевдонимы (такие как claude-sonnet-4-5). Найдите любую строку модели, которую вы передаёте в Messages API, и вы обнаружите её ровно в одной записи model_group.



Что означает, если группа отсутствует в ответе рабочего пространства?

Рабочее пространство не имеет переопределения для этой группы и наследует лимит уровня организации. Запросите конечную точку организации, чтобы увидеть унаследованные значения.



Могу ли я обновить ограничения скорости с помощью этого API?

Нет. Чтобы установить ограничения скорости рабочего пространства, откройте рабочее пространство в Claude Console и используйте вкладку Limits.



См. также

• Ограничения скорости
• Admin API
• Справочник Admin API
• Рабочие пространства
• Usage and Cost API