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

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

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

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

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

Ведущие платформы наблюдаемости предлагают готовые интеграции для мониторинга использования и стоимости 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" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ADMIN_API_KEY"

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-6&\
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"

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

Отслеживайте ваши элементы управления месторасположением данных, группируя и фильтруя использование с помощью измерения 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"

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

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"

Разбиение на страницы

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

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"

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

Изучите детальные реализации в 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% скидка на пакетные запросы
• Ограничения скорости - Понимайте уровни использования
• Месторасположение данных - Управляйте географией вывода