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

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

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

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

Организации Claude Enterprise вместо этого используют ключ Analytics API с другим API; см. Какой API вам нужен?.



Какой API вам нужен?

Anthropic предоставляет отчётность о затратах и использовании через два API, в зависимости от того, каким продуктом Claude управляет ваша организация:

Родительские организации Claude Enterprise не отображаются в Claude Console и не имеют ключей Admin API, поэтому для них ключ Analytics API — единственный путь к этим данным. См. Analytics APIs, чтобы узнать, как создать каждый тип ключа и к каким планам применяются данные о затратах Claude Enterprise.



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

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



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

Получите ежедневное использование вашей организации за последние 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" \
  -H "anthropic-version: 2023-06-01" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY"

User-Agent: YourApp/1.0.0 (https://yourapp.com)



Usage API

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



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

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

Полные сведения о параметрах и схемах ответов см. в справочнике Usage 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" \
  -H "anthropic-version: 2023-06-01" \
  -H "x-api-key: $ANTHROPIC_ADMIN_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-5&\
service_tiers[]=batch&\
context_window[]=0-200k&\
bucket_width=1h" \
  -H "anthropic-version: 2023-06-01" \
  -H "x-api-key: $ANTHROPIC_ADMIN_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" \
  -H "anthropic-version: 2023-06-01" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY"



Резидентность данных

Отслеживайте ваши элементы управления резидентностью данных, группируя и фильтруя использование по измерению 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" \
  -H "anthropic-version: 2023-06-01" \
  -H "x-api-key: $ANTHROPIC_ADMIN_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" \
  -H "anthropic-version: 2023-06-01" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY"



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

Отслеживайте использование быстрого режима, группируя и фильтруя по измерению 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" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: fast-mode-2026-02-01" \
  -H "x-api-key: $ANTHROPIC_ADMIN_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" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: fast-mode-2026-02-01" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY"



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



Cost API

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



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

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

Полные сведения о параметрах и схемах ответов см. в справочнике Cost 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" \
  -H "anthropic-version: 2023-06-01" \
  -H "x-api-key: $ANTHROPIC_ADMIN_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" \
  -H "anthropic-version: 2023-06-01" \
  -H "x-api-key: $ANTHROPIC_ADMIN_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..." \
  -H "anthropic-version: 2023-06-01" \
  -H "x-api-key: $ANTHROPIC_ADMIN_KEY"



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

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

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



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



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

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



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

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



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

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



Как отслеживать использование Priority Tier?

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



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

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



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

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



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

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



См. также

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

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