The Admin API is unavailable for individual accounts. To collaborate with teammates and add members, set up your organization in Console → Settings → Organization.
Admin API для использования и стоимости предоставляет программный и детализированный доступ к историческим данным об использовании API и стоимости для вашей организации. Эти данные аналогичны информации, доступной на страницах Использование и Стоимость консоли Anthropic. Этот API позволяет вам лучше отслеживать, анализировать и оптимизировать ваши реализации Claude:
  • Точное отслеживание использования: Получайте точные подсчеты токенов и паттерны использования вместо того, чтобы полагаться исключительно на подсчет токенов ответа
  • Сверка стоимости: Сопоставляйте внутренние записи с выставлением счетов Anthropic для финансовых и бухгалтерских команд
  • Производительность и улучшение продукта: Отслеживайте производительность продукта, измеряя, улучшили ли изменения в системе его работу, или настройте оповещения
  • Оптимизация ограничений скорости и приоритетного уровня: Оптимизируйте функции, такие как кэширование промптов или конкретные промпты, чтобы максимально использовать выделенную мощность, или приобретите выделенную мощность.
  • Расширенный анализ: Выполняйте более глубокий анализ данных, чем доступно в консоли
Требуется ключ Admin APIЭтот API является частью Admin API. Эти конечные точки требуют ключ Admin API (начинающийся с sk-ant-admin...), который отличается от стандартных ключей API. Только члены организации с ролью администратора могут предоставлять ключи Admin API через консоль Anthropic.

​
Партнерские решения

Ведущие платформы наблюдаемости предлагают готовые интеграции для мониторинга использования и стоимости вашего Claude API без написания пользовательского кода. Эти интеграции предоставляют панели мониторинга, оповещения и аналитику, чтобы помочь вам эффективно управлять использованием API.

Datadog

Наблюдаемость LLM с автоматическим трассированием и мониторингом

Grafana Cloud

Интеграция без агентов для простой наблюдаемости LLM с готовыми панелями мониторинга и оповещениями

Honeycomb

Расширенные запросы и визуализация через OpenTelemetry

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

Получите ежедневное использование вашей организации за последние 7 дней: 
curl "https://api.anthropic.com/v1/organizations/usage_report/messages?\
starting_at=2025-01-08T00:00:00Z&\
ending_at=2025-01-15T00:00:00Z&\
bucket_width=1d" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ADMIN_API_KEY"
Установите заголовок User-Agent для интеграцийЕсли вы создаете интеграцию, установите заголовок User-Agent, чтобы помочь нам понять паттерны использования:
User-Agent: YourApp/1.0.0 (https://yourapp.com)

​
API использования

Отслеживайте потребление токенов в вашей организации с детальной разбивкой по модели, рабочему пространству и уровню обслуживания с помощью конечной точки /v1/organizations/usage_report/messages.

​
Ключевые концепции

  • Временные корзины: Агрегируйте данные об использовании в фиксированных интервалах (1m, 1h или 1d)
  • Отслеживание токенов: Измеряйте некэшированные входные, кэшированные входные, создание кэша и выходные токены
  • Фильтрация и группировка: Фильтруйте по ключу API, рабочему пространству, модели, уровню обслуживания или контекстному окну, и группируйте результаты по этим измерениям
  • Использование серверных инструментов: Отслеживайте использование серверных инструментов, таких как веб-поиск
Для полных деталей параметров и схем ответов см. справочник API использования.

​
Базовые примеры

​
Ежедневное использование по модели

curl "https://api.anthropic.com/v1/organizations/usage_report/messages?\
starting_at=2025-01-01T00:00:00Z&\
ending_at=2025-01-08T00:00:00Z&\
group_by[]=model&\
bucket_width=1d" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ADMIN_API_KEY"

​
Почасовое использование с фильтрацией

curl "https://api.anthropic.com/v1/organizations/usage_report/messages?\
starting_at=2025-01-15T00:00:00Z&\
ending_at=2025-01-15T23:59:59Z&\
models[]=claude-sonnet-4-20250514&\
service_tiers[]=batch&\
context_window[]=0-200k&\
bucket_width=1h" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ADMIN_API_KEY"

​
Фильтрация использования по ключам API и рабочим пространствам

curl "https://api.anthropic.com/v1/organizations/usage_report/messages?\
starting_at=2025-01-01T00:00:00Z&\
ending_at=2025-01-08T00:00:00Z&\
api_key_ids[]=apikey_01Rj2N8SVvo6BePZj99NhmiT&\
api_key_ids[]=apikey_01ABC123DEF456GHI789JKL&\
workspace_ids[]=wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ&\
workspace_ids[]=wrkspc_01XYZ789ABC123DEF456MNO&\
bucket_width=1d" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ADMIN_API_KEY"
Чтобы получить идентификаторы ключей API вашей организации, используйте конечную точку Список ключей API.Чтобы получить идентификаторы рабочих пространств вашей организации, используйте конечную точку Список рабочих пространств или найдите идентификаторы рабочих пространств вашей организации в консоли Anthropic.

​
Ограничения временной детализации

ДетализацияЛимит по умолчаниюМаксимальный лимитСлучай использования
1m60 корзин1440 корзинМониторинг в реальном времени
1h24 корзины168 корзинЕжедневные паттерны
1d7 корзин31 корзинаЕженедельные/ежемесячные отчеты

​
API стоимости

Получайте разбивку стоимости на уровне сервиса в долларах США с помощью конечной точки /v1/organizations/cost_report.

​
Ключевые концепции

  • Валюта: Все стоимости в долларах США, представленные как десятичные строки в наименьших единицах (центы)
  • Типы стоимости: Отслеживайте стоимость использования токенов, веб-поиска и выполнения кода
  • Группировка: Группируйте стоимости по рабочему пространству или описанию для детальной разбивки
  • Временные корзины: Только ежедневная детализация (1d)
Для полных деталей параметров и схем ответов см. справочник API стоимости.
Стоимости приоритетного уровня используют другую модель выставления счетов и не включены в конечную точку стоимости. Отслеживайте использование приоритетного уровня через конечную точку использования.

​
Базовый пример

curl "https://api.anthropic.com/v1/organizations/cost_report?\
starting_at=2025-01-01T00:00:00Z&\
ending_at=2025-01-31T00:00:00Z&\
group_by[]=workspace_id&\
group_by[]=description" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ADMIN_API_KEY"

​
Пагинация

Обе конечные точки поддерживают пагинацию для больших наборов данных:
  1. Сделайте ваш первоначальный запрос
  2. Если has_more равно true, используйте значение next_page в вашем следующем запросе
  3. Продолжайте, пока has_more не станет false
# Первый запрос
curl "https://api.anthropic.com/v1/organizations/usage_report/messages?\
starting_at=2025-01-01T00:00:00Z&\
ending_at=2025-01-31T00:00:00Z&\
limit=7" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ADMIN_API_KEY"

# Ответ включает: "has_more": true, "next_page": "page_xyz..."

# Следующий запрос с пагинацией
curl "https://api.anthropic.com/v1/organizations/usage_report/messages?\
starting_at=2025-01-01T00:00:00Z&\
ending_at=2025-01-31T00:00:00Z&\
limit=7&\
page=page_xyz..." \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ADMIN_API_KEY"

​
Общие случаи использования

Изучите детальные реализации в anthropic-cookbook:
  • Ежедневные отчеты об использовании: Отслеживайте тренды потребления токенов
  • Атрибуция стоимости: Распределяйте расходы по рабочим пространствам для возвратных платежей
  • Эффективность кэша: Измеряйте и оптимизируйте кэширование промптов
  • Мониторинг бюджета: Настройте оповещения для пороговых значений расходов
  • Экспорт CSV: Генерируйте отчеты для финансовых команд

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

​
Насколько свежие данные?

Данные об использовании и стоимости обычно появляются в течение 5 минут после завершения запроса API, хотя задержки могут иногда быть дольше.

​
Какая рекомендуемая частота опроса?

API поддерживает опрос один раз в минуту для устойчивого использования. Для коротких всплесков (например, загрузка данных с пагинацией) более частый опрос приемлем. Кэшируйте результаты для панелей мониторинга, которым нужны частые обновления.

​
Как отслеживать использование выполнения кода?

Стоимости выполнения кода появляются в конечной точке стоимости, сгруппированные под Code Execution Usage в поле описания. Выполнение кода не включено в конечную точку использования.

​
Как отслеживать использование приоритетного уровня?

Фильтруйте или группируйте по service_tier в конечной точке использования и ищите значение priority. Стоимости приоритетного уровня недоступны в конечной точке стоимости.

​
Что происходит с использованием Workbench?

Использование API из Workbench не связано с ключом API, поэтому api_key_id будет null, даже при группировке по этому измерению.

​
Как представлено рабочее пространство по умолчанию?

Использование и стоимости, отнесенные к рабочему пространству по умолчанию, имеют значение null для workspace_id.

​
См. также

API использования и стоимости можно использовать для улучшения опыта ваших пользователей, управления затратами и сохранения ваших ограничений скорости. Узнайте больше о некоторых из этих других функций: