API ограничений скорости

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

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

• Синхронизировать шлюзы и прокси: Считывайте текущие ограничения при запуске и по расписанию вместо жёсткого кодирования значений, которые устаревают, когда Anthropic их корректирует.
• Обеспечивать внутреннее оповещение: Сравнивайте данные об использовании из 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 — настроенное ограничение. См. Ограничения скорости, чтобы узнать, как измеряется и применяется каждый ограничитель.

Полные сведения о параметрах и схемах ответов см. в справочнике по 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-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-4-8" \
  --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, если у организации нет настроенного ограничения для этого типа ограничителя.

Полные сведения о параметрах и схемах ответов см. в справочнике по 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-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
• Рабочие пространства
• API использования и стоимости