Claude Usage and Cost Analytics API: витрати й токени за моделями та ключами

29 жовтня 2026 року Anthropic запустила в беті Usage and Cost Analytics API для організацій Claude Console та Claude Enterprise. Тепер дані про токени й витрати можна отримувати програмно, а не лише переглядати в консолі.

Що нового

Є два ендпоінти: один повертає кількість токенів і запитів, другий — вартість у доларах США. Результати можна групувати та фільтрувати за моделлю, робочим простором, API-ключем або користувачем, а також будувати щоденні чи погодинні ряди для дашбордів. Групувати одночасно можна щонайбільше за п’ятьма вимірами. Старий Usage and Cost API лишається підтримуваним, але тепер вважається застарілим.

Як спробувати

Для Claude Console потрібен Admin API key, для Enterprise — ключ із доступом read:analytics. Кожен запит має містити заголовок anthropic-beta: analytics-usage-cost-2026-08-24 і заголовок версії API. SDK і ant CLI додають їх самі. Для сервісу, який збирає дані, документація радить окремий ключ у сховищі секретів або правило Workload Identity Federation замість довгоживучого ключа.

Обмеження

Функція в беті, а індивідуальні акаунти не мають доступу до Admin API. Один запит охоплює не більше 31 дня, а дані доступні лише з 1 січня 2026 року й за останні 365 днів. Зазвичай дані оновлюються протягом 4 годин, але можуть відставати до 24 годин, а підсумки місяця змінюються ще близько 7 днів після його завершення. Окремої ціни за цей API документація не вказує.