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

The Admin API is unavailable for individual accounts. To collaborate with teammates and add members, set up your organization in Console → Settings → Organization.

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

Этот API позволяет вам лучше отслеживать, анализировать и оптимизировать ваши реализации Claude:

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

Требуется ключ Admin API

Этот API является частью Admin API. Эти конечные точки требуют ключ Admin API (начинающийся с sk-ant-admin...), который отличается от стандартных ключей API. Только члены организации с ролью администратора могут предоставить ключи Admin API через Claude Console.

Решения партнёров

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

CloudZero

Платформа облачной аналитики для отслеживания и прогнозирования затрат

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

Получите ежедневное использование вашей организации за последние 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-opus-4-7&\
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"

Чтобы получить ID ключей API вашей организации, используйте конечную точку Список ключей API.

Чтобы получить ID рабочих пространств вашей организации, используйте конечную точку Список рабочих пространств или найдите ID рабочих пространств вашей организации в консоли Anthropic.

Местоположение данных

Отслеживайте ваши элементы управления местоположением данных, группируя и фильтруя использование с помощью измерения inference_geo. Это полезно для проверки географической маршрутизации в вашей организации.

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

Вы также можете фильтровать по определённой географии. Допустимые значения: global, us и not_available:

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

Модели, выпущенные до февраля 2026 года (до Claude Opus 4.6), не поддерживают параметр запроса inference_geo, поэтому их отчёты об использовании возвращают "not_available" для этого измерения. Вы можете использовать not_available как значение фильтра в inference_geos[] для целевых моделей.

Быстрый режим (бета: исследовательский предпросмотр)

Отслеживайте использование быстрого режима, группируя и фильтруя с помощью измерения speed. Это полезно для мониторинга использования стандартного режима и быстрого режима.

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

Вы также можете фильтровать по определённой скорости. Допустимые значения: standard и fast:

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

Как фильтр speeds[], так и значение speed group_by требуют заголовок бета fast-mode-2026-02-01.

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

Детализация	Ограничение по умолчанию	Максимальное ограничение	Вариант использования
`1m`	60 интервалов	1440 интервалов	Мониторинг в реальном времени
`1h`	24 интервала	168 интервалов	Ежедневные паттерны
`1d`	7 интервалов	31 интервал	Еженедельные/ежемесячные отчёты

API стоимости

Получайте разбивки стоимости на уровне обслуживания в USD с помощью конечной точки /v1/organizations/cost_report.

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

Валюта: все затраты в USD, указанные как десятичные строки в наименьших единицах (центы)
Типы затрат: отслеживайте затраты на использование токенов, веб-поиск и выполнение кода
Группировка: группируйте затраты по рабочему пространству или описанию для детальных разбивок. При группировке по description ответы включают разобранные поля, такие как model и inference_geo
Временные интервалы: только ежедневная детализация (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"

Пагинация

Обе конечные точки поддерживают пагинацию для больших наборов данных:

Сделайте ваш начальный запрос
Если has_more равно true, используйте значение next_page в вашем следующем запросе
Продолжайте до тех пор, пока 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"

Распространённые варианты использования

Изучите детальные реализации в Claude Cookbook:

Ежедневные отчёты об использовании: отслеживайте тренды потребления токенов
Атрибуция затрат: распределяйте расходы по рабочему пространству для возмещения затрат
Эффективность кэша: измеряйте и оптимизируйте кэширование подсказок
Мониторинг бюджета: установите оповещения для пороговых значений расходов
Экспорт CSV: создавайте отчёты для финансовых команд

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

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

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

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

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

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

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

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

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

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

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

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

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

Как получить разбивки затрат на пользователя для Claude Code?

Используйте API аналитики Claude Code, который предоставляет предполагаемые затраты на пользователя и метрики производительности без ограничений производительности при разбивке затрат по множеству ключей API. Для общего использования API с множеством ключей используйте API использования для отслеживания потребления токенов как прокси стоимости.

См. также

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

Обзор Admin API
Справочник Admin API
Цены
Кэширование подсказок - оптимизируйте затраты с помощью кэширования
Пакетная обработка - скидка 50% на пакетные запросы
Ограничения скорости - поймите уровни использования
Местоположение данных - контролируйте географию вывода