Przejdź do treści
sobolewski.proAI dziś, o 20:00Zapisz się

Raz dziennie, wypiszesz się jednym kliknięciem. Polityka prywatności

Linked billing w Claude API: za tokeny płaci klient

Linked billing w Claude API pozwala obciążyć kosztem tokenów organizację klienta zamiast twórcy aplikacji. Sprawdźmy, jak działa i kogo nie obejmuje.

3 min czytania

Ten artykuł w innych językach:English

W tym artykule
  1. Jak działa Linked billing w Claude API?
  2. Co kontroluje klient?
  3. Kogo Linked billing nie obejmuje?
  4. Na co zwrócić uwagę?
  5. FAQ

17 listopada Anthropic udostępnił w becie Linked billing: klient aplikacji zbudowanej na Claude API może płacić za jej użycie Claude przez własną organizację w Claude Platform. Informację znajdziemy w Claude Release Notes, a szczegóły w dokumentacji Linked billing.

Jak działa Linked billing w Claude API?

Klient łączy swoją organizację z aplikacją raz, przez OAuth. Zgodę wyraża na stronie Anthropic (auth.claude.com) i musi mieć w swojej organizacji rolę Admin albo Billing. Aplikacja nie dostaje od niego żadnego klucza API, tylko token ograniczony do tego jednego połączenia, ważny najwyżej godzinę.

Od tej chwili twórca aplikacji przy każdym zapytaniu do /v1/messages albo /v1/chat/completions wybiera, kto płaci. Służy do tego pole billing_policy i nagłówek beta user-profiles-billing-2026-10-01:

"billing_policy": {"type": "billing_policy", "bill_to": "user_profile"}

Wartość user_profile obciąża klienta, a self (albo brak pola) twórcę aplikacji. Jeśli zapytania oznaczonego na koszt klienta nie da się na niego zaksięgować, API je odrzuca, zamiast po cichu obciążyć twórcę.

Klient płaci Anthropic bezpośrednio. Twórca aplikacji widzi w Claude Console i w Usage and Cost Analytics API liczbę zapytań i tokenów każdego profilu, ale nie zobaczy, ile klient zapłacił ani jakie ma stawki.

Co kontroluje klient?

Już przy łączeniu klient może ustawić miesięczny limit wydatków dla danej aplikacji, w pełnych dolarach. Po jego osiągnięciu API odrzuca zapytania na koszt klienta z błędem 402, aż do pierwszego dnia kolejnego miesiąca (00:00 UTC) albo do podniesienia limitu. Najniższy możliwy limit to 0 USD, który blokuje wszystko.

Połączeniami zarządza się na stronie Linked platforms w Claude Console. Tam widać, ile aplikacja kosztowała organizację w tym miesiącu, i tam można ją odłączyć w dowolnej chwili. Co ciekawe, twórca aplikacji nie dostaje wtedy żadnego powiadomienia (ani webhooka, ani e-maila) i o odłączeniu dowiaduje się z błędu 403 user_profile_not_billable przy następnym zapytaniu.

Kogo Linked billing nie obejmuje?

Najważniejsze ograniczenie dotyczy tego, kto w ogóle może zapłacić. Organizacja klienta musi płacić Anthropic bezpośrednio za użycie API, z przedpłaconych kredytów albo na fakturę. Odpadają organizacje rozliczane przez AWS, Google Cloud albo Azure oraz te, które mają wyłącznie subskrypcję Claude.

Linked billing nie jest więc sposobem na to, żeby w cudzej aplikacji wykorzystać swój plan Max albo Ultra. Dokumentacja mówi o tym wprost: miesięczne kredyty API z planów Max, Ultra i Team nie pokryją takich zapytań, podobnie jak kredyty z programów partnerskich i startupowych.

Na co zwrócić uwagę?

Po pierwsze, na to, w czyjej organizacji działają zapytania. Płaci klient, ale zapytania wykonują się w organizacji twórcy aplikacji, więc obowiązują jej limity zapytań, jej retencja danych i jej ustawienia szyfrowania. Dokumentacja odradza łączenie klientów, którzy dla tego użycia potrzebują HIPAA, FERPA albo CMEK.

Po drugie, na nagłówek z profilem. Zapytanie wysłane poświadczeniem operatora, które wskaże inny połączony profil, obciąży organizację tego profilu bez żadnego błędu. Udana odpowiedź nie mówi też, kto zapłacił, więc trzeba to zapisywać po swojej stronie.

Po trzecie, na to, czego na koszt klienta nie wyślemy. Message Batches nie obsługują tego trybu, a zapytanie do /v1/messages z płatnym wykonywaniem kodu kończy się błędem 400.

Po czwarte, na etap testów. Dopóki aplikacja nie jest opublikowana, połączyć się z nią mogą tylko osoby z listy testowych użytkowników, a limit wydatków jest obowiązkowy i wynosi najwyżej 50 USD miesięcznie. Publikacja wymaga potwierdzenia domeny rekordem DNS TXT i weryfikacji przez Anthropic (chyba że organizacja twórcy rozlicza się na fakturę, wtedy aplikacja jest publiczna od razu).

Sama konfiguracja też nie jest na jeden wieczór. Anthropic nie wydaje sekretu klienta: backend uwierzytelnia się asercją private_key_jwt od własnego dostawcy tożsamości, a konto serwisowe operatora powstaje przez Workload Identity Federation. Jeśli dopiero zaczynamy z API, lepiej najpierw zbudować zwykłego agenta, a rozliczenia zostawić na później ;)

FAQ

Czy Linked billing działa z subskrypcją Claude Pro albo Max?

Nie. Organizacja klienta musi płacić Anthropic bezpośrednio za API, z przedpłaconych kredytów albo na fakturę. Sama subskrypcja Claude nie wystarczy.

Czy klient musi podać aplikacji swój klucz API?

Nie. Klient zatwierdza połączenie na stronie Anthropic, a aplikacja dostaje token OAuth, którym może obciążyć tylko tę jedną organizację.

Co się dzieje, gdy klient osiągnie limit wydatków?

API odrzuca zapytania na jego koszt z błędem 402. Twórca aplikacji może wtedy wysłać zapytanie ponownie na własny koszt, z bill_to: "self".

  • AI
  • Anthropic
  • Claude
  • API

AI dziś, o 20:00

Codziennie wieczorem najważniejsze wiadomości ze świata AI i nowe wpisy z bloga. Krótko, ze źródłami.

Raz dziennie, wypiszesz się jednym kliknięciem. Polityka prywatności