Koszty Claude API: nowe API pokaże, kto i na co wydaje tokeny

29 października Anthropic udostępnił w becie Usage and Cost Analytics API, nowe API do raportowania zużycia tokenów i kosztów Claude API w organizacji. Według Claude Release Notes dotychczasowe Usage and Cost API staje się od tego dnia API „legacy”, choć nadal jest wspierane.

Co nowego w raportowaniu kosztów Claude API?

API ma dwa endpointy:

1. GET /v1/organizations/analytics/usage zwraca liczby tokenów i zapytań,
2. GET /v1/organizations/analytics/cost zwraca koszt w USD.

Najciekawsze jest to, po czym możemy te dane pociąć. W jednym zapytaniu grupujemy wyniki po maksymalnie pięciu wymiarach: modelu, workspace, kluczu API, tierze usługi, oknie kontekstu, regionie inferencji, produkcie i tzw. „aktorze”, czyli tym, kto faktycznie wysłał zapytanie. Aktorem może być użytkownik, konto serwisowe, tożsamość z AWS albo Google Cloud, a jeśli nikogo takiego nie ma, sam klucz API.

Wyniki przychodzą jako ranking, domyślnie od największego zużycia. Pytanie „które klucze API wydały najwięcej w tym miesiącu?” to więc jedno zapytanie, a nie skrypt sklejający dane z wielu raportów.

Dla Claude Code jest gotowy przepis: koszt na użytkownika daje zapytanie z products[]=claude_code&group_by[]=actor. Po pomiarach, według których ukryte podsumowania agentów zjadają 16–22% kosztów sesji, to akurat bardzo na czasie.

Jak wygląda zapytanie?

Przykład z dokumentacji: dzienne zużycie tokenów z pierwszego tygodnia września, osobno dla każdego modelu.

curl --globoff "https://api.anthropic.com/v1/organizations/analytics/usage?\
starting_at=2026-09-01T00:00:00Z&\
ending_at=2026-09-08T00:00:00Z&\
time_bucket_width=1d&\
group_by[]=model&\
limit=10" \
  -H "anthropic-version: 2023-06-01" \
  -H "anthropic-beta: analytics-usage-cost-2026-08-24" \
  -H "x-api-key: $ANTHROPIC_API_KEY"

Każdy wiersz ma trzy części: zakres czasu, group z wymiarami i usage (albo cost) z liczbami. W usage znajdziemy m.in. tokeny wejściowe bez cache, tokeny zapisane i odczytane z cache, tokeny wyjściowe, liczbę wyszukiwań w sieci i liczbę zapytań. To samo jest dostępne przez SDK i CLI ant (ant beta:organization:analytics:usage list).

Kilka szczegółów:

1. Przedziały czasu to 1 minuta, 1 godzina albo 1 dzień, wszystko w UTC.
2. Jedno zapytanie obejmuje maksymalnie 31 dni, a przy przedziałach minutowych tylko 24 godziny.
3. Dane sięgają do 1 stycznia 2026 i najwyżej 365 dni wstecz.
4. Strona wyników ma od 1 do 1000 wierszy (domyślnie 20).

Co pokazuje endpoint kosztów?

Endpoint /cost zwraca dwie kwoty: amount, czyli koszt po rabatach, a przed odjęciem kredytów, oraz list_amount, czyli koszt po cenach katalogowych. Kwoty są podawane w centach z sześcioma miejscami po przecinku, więc "41280.000000" oznacza 412,80 USD.

Dwa dodatkowe wymiary, cost_type i token_type, rozbijają koszt na tokeny poszczególnych typów, wyszukiwanie w sieci, wykonywanie kodu i sesje. Nie liczą się do limitu pięciu wymiarów.

Na co zwrócić uwagę?

Po pierwsze, na opóźnienie. Dane odświeżają się zwykle w ciągu 4 godzin, a czasem do 24 godzin, podczas gdy w starym Usage and Cost API pojawiały się zwykle w ciągu 5 minut. Do alertów „tu i teraz” lepiej więc szukać czegoś innego.

Po drugie, na korekty. Wartości mogą się zmieniać jeszcze przez ok. 7 dni po końcu miesiąca kalendarzowego, więc ostateczne sumy za październik dostaniemy w okolicach 7 listopada.

Po trzecie, na Priority Tier. Zapytania w ramach wykupionego Priority Tier widać w zużyciu, ale ich koszt tokenów wynosi zero, bo opłatę za commitment rozlicza się osobno.

Po czwarte, na dostęp. API działa tylko dla organizacji: w Claude Console z kluczem Admin API, a w Claude Enterprise z kluczem z uprawnieniem read:analytics. Konta indywidualne z niego nie skorzystają. Działa też na Claude Platform on AWS i w Claude Models on Google Cloud, z uwierzytelnianiem danej chmury.

Czy to coś nowego w świecie AI?

Raporty kosztów w Claude Console były już wcześniej. Nowe jest to, że te same endpointy i pola obsługują zarówno organizacje w Claude Console, jak i Claude Enterprise. Dla Enterprise to też koniec limitu: stare raporty zwracały tylko 100 największych grup w każdym przedziale, nowe zwracają wszystkie.

To kolejny krok Anthropic w stronę kontroli wydatków, tuż po Claude smart reports, które pokazują, co zespół zrobił z Claude’em i ile to kosztowało.

FAQ

Jak sprawdzić koszty Claude API?

W Claude Console na stronach Usage i Cost albo programowo przez Usage and Cost Analytics API (endpoint /v1/organizations/analytics/cost) z kluczem Admin API. Pojedyncza odpowiedź API zawiera też blok usage z liczbą tokenów danego zapytania.

Czy stare Usage and Cost API przestanie działać?

Na dzień 29 października nie. Według Claude Release Notes ma status „legacy”, ale nadal jest wspierane, a dokumentacja zawiera instrukcję migracji.

Jak sprawdzić, ile wydaje każdy użytkownik Claude Code?

Endpointem kosztów z parametrami products[]=claude_code&group_by[]=actor. Organizacje w Claude Console mogą też użyć osobnego Claude Code Analytics API.