API использования и стоимости
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 и стоимости для вашей организации. Эти данные аналогичны информации, доступной на страницах Использование и Стоимость в консоли Claude.
Этот API позволяет вам лучше отслеживать, анализировать и оптимизировать ваши реализации Claude:
- Точное отслеживание использования: Получайте точные подсчеты токенов и паттерны использования вместо того, чтобы полагаться исключительно на подсчет токенов ответов
- Сверка затрат: Сопоставляйте внутренние записи с выставлением счетов Anthropic для финансовых и бухгалтерских команд
- Производительность продукта и улучшения: Отслеживайте производительность продукта, измеряя, улучшили ли изменения в системе его работу, или настройте оповещения
- Оптимизация ограничений скорости и приоритетного уровня: Оптимизируйте функции, такие как кэширование промптов или конкретные промпты, чтобы максимально использовать выделенную мощность, или приобретите выделенную мощность.
- Расширенный анализ: Выполняйте более глубокий анализ данных, чем доступно в консоли
Требуется ключ Admin API
Этот API является частью Admin API. Эти конечные точки требуют ключ Admin API (начинающийся с sk-ant-admin...), который отличается от стандартных ключей API. Только участники организации с ролью администратора могут предоставлять ключи Admin API через консоль Claude.
Партнерские решения
Ведущие платформы наблюдаемости предлагают готовые к использованию интеграции для мониторинга использования и стоимости вашего 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-5-20250929&\
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.
Ограничения временной детализации
| Детализация | Лимит по умолчанию | Максимальный лимит | Случай использования |
|---|---|---|---|
1m | 60 корзин | 1440 корзин | Мониторинг в реальном времени |
1h | 24 корзины | 168 корзин | Ежедневные паттерны |
1d | 7 корзин | 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"Пагинация
Обе конечные точки поддерживают пагинацию для больших наборов данных:
- Сделайте ваш первоначальный запрос
- Если
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"Распространенные случаи использования
Изучите подробные реализации в anthropic-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% скидка на пакетные запросы
- Ограничения скорости - Понимание уровней использования