Anthropic wprowadził w wersji beta Usage and Cost Analytics API, nowy zestaw endpointów, który umożliwia organizacjom korzystającym z Claude Console i Claude Enterprise dostęp do szczegółowych danych dotyczących zużycia tokenów oraz wydatków. Użytkownicy mogą teraz korzystać z elastycznego narzędzia do filtrowania i grupowania danych według modelu, workspace'a czy klucza API, zamiast polegać na sztywnych, predefiniowanych raportach.
Najważniejsze fakty
- Nowe endpointy
/v1/organizations/analytics/usagei/v1/organizations/analytics/costzwracają dane o tokenach i kosztach w USD. - API wymaga nagłówka beta
anthropic-beta: analytics-usage-cost-2026-08-24oraz klucza z uprawnieniemread:analytics. - Stare endpointy – Usage and Cost API oraz raporty Enterprise Analytics – przechodzą do statusu legacy.
- Grupowanie możliwe jest po wymiarach takich jak model, workspace, klucz API czy użytkownik.
- Dane kosztowe raportowane są w dolarach amerykańskich z możliwością podziału na przedziały czasowe.
Co dokładnie mierzy nowe API
Endpoint Usage pokazuje liczbę tokenów i żądań w wybranym zakresie dat. API potrafi rozbić zużycie na kategorie tokenów wejściowych – zwykłych, użytych do tworzenia cache oraz odczytanych z cache – oraz tokenów wyjściowych. Dodatkowo, dostarcza liczbę żądań.
Endpoint Cost działa podobnie, ale operuje na kwotach w dolarach. Oba endpointy wspierają parametr time_bucket_width, co pozwala na grupowanie danych w interwały czasowe – godziny, dni, czy inne, które pasują do wewnętrznych raportów. Duże odpowiedzi API są obsługiwane przez paginację, co eliminuje ryzyko, że zapytanie utknie na wielomiesięcznym zakresie danych.
Wynik to jedna linia na każdą kombinację wymiarów z aktywnością w zadanym okresie. Jeśli nie podasz żadnego grupowania, otrzymasz jeden zagregowany wiersz.
Koniec starych raportów
Anthropic oznaczył poprzednie API jako legacy. Dotyczy to zarówno całego Usage and Cost API, jak i czterech konkretnych endpointów Enterprise Analytics: usage_report, cost_report, user_usage_report oraz user_cost_report.
Stare endpointy nadal działają, ale zespół Anthropic zachęca do migracji. Dla zespołów DevOps to sygnał, że nowe dashboardy, systemy chargebacków i alerty budżetowe warto budować na nowym API. Stare integracje mogą jeszcze funkcjonować, ale kierunek rozwoju jest jasny.
Przejście z kilku osobnych raportów na dwa endpointy analityczne upraszcza architekturę po stronie klienta. Zamiast osobnych zapytań o raport organizacyjny, per-user i per-koszt, można teraz korzystać z jednego źródła i wybierać tylko te wymiary, które są naprawdę potrzebne.
Dlaczego to ma znaczenie dla zespołów technicznych
Największą zmianą jest możliwość integracji danych tokenowych i kosztowych bezpośrednio z istniejącym toolchainem. Monitoring, FinOps, pipeline'y CI/CD – wszystko, co już działa w organizacji, może teraz korzystać z tych danych bez konieczności ręcznego eksportowania CSV z konsoli.
Grupowanie po kluczu API, workspace lub tożsamości serwisowej jest szczególnie przydatne. Umożliwia to powiązanie wydatków na Anthropic z konkretnymi aplikacjami, środowiskami czy zespołami. Choć API nie jest jeszcze w pełni zgodne ze specyfikacją FOCUS, kierunek rozwoju jest zbieżny z innymi platformami chmurowymi.
API jest w fazie beta, co oznacza, że mogą wystąpić zmiany przed stabilizacją interfejsu. Integracje produkcyjne powinny być przygotowane na aktualizacje, zanim Anthropic zakończy fazę beta. Mimo to, kierunek jest jasny: precyzyjna kontrola kosztów AI staje się standardem dostępnym przez API, a nie tylko przywilejem największych klientów.
Dodaj komentarz