Przejdź do treści

Claude API: klucz, ceny za tokeny i pierwsze zapytanie

Adam Marzec
Mapa pomiarowa: karta CLAUDE API z wartością 0,10 USD od 1M tokenów wejścia, wiersze o modelach Haiku 5.5, Sonnet 5.5, Opus 5.5 i Fable 5.1 ze stawkami, pieczątka BRAK DARMOWEGO TIERU, trzy pomiary: endpoint POST /v1/messages, tiery limitów Start, Build i Scale, paczki wsadowe tańsze o połowę; kropkowane ścieżki do kapsuł KONSOLA, KLUCZ, ZAPYTANIE, ODPOWIEDŹ; stan 13.10.2026

Api Claude to druga twarz tej samej firmy, którą znasz z okienka czatu. Zamiast abonamentu i limitów wiadomości płacisz za tokeny przy każdym zapytaniu, zamiast interfejsu w przeglądarce wołasz model z własnego kodu, a zamiast konta na claude.com zakładasz konto w konsoli deweloperskiej. Ten poradnik prowadzi przez całą ścieżkę: czym API różni się od subskrypcji, jak założyć konto i kupić kredyty, jak wygenerować klucz tak, żeby nie wyciekł, jak wygląda minimalne zapytanie i ile to wszystko kosztuje przy obecnych stawkach. Wszystkie nasze teksty o tym asystencie zbiera strona tematyczna Claude, a pełny przegląd cen, także planów abonamentowych, trzymamy w ściądze cennika.

Najważniejsze informacje

CoSzczegóły
Konsolaplatform.claude.com, kiedyś console.anthropic.com, konto osobne od czatu
Klucz APISettings, sekcja API keys; przy tworzeniu wybierasz typ i czas wygaśnięcia
ZapytaniePOST /v1/messages, pola model, max_tokens, messages
Najtańszy modelHaiku 5.5: 0,10 USD za milion tokenów wejścia, 0,50 USD wyjścia
Najdroższy modelFable 5.1: 10 i 50 USD za milion tokenów
Darmowe kredytybrak; API rozlicza się z kupionych kredytów od pierwszego tokena

Stawki, ścieżki w konsoli i limity przeczytałem w dokumentacji i cenniku producenta trzynastego października 2026, a w miejscach, gdzie dokumentacja milczy, piszę wprost, że dane nie są publikowane, zamiast podawać liczby z drugiej ręki. Jedno trzeba rozbroić na starcie: fraza „claude api key free” żyje w podpowiedziach wyszukiwarki, ale darmowego tieru API nie ma. Klucz wygenerujesz za darmo, natomiast każde zapytanie do modelu kosztuje od pierwszego tokena, więc „free” w tym kontekście oznacza co najwyżej brak opłaty za sam klucz.

Czym API różni się od subskrypcji Claude

Subskrypcja Claude to abonament: płacisz 17 albo 20 dolarów za Pro, dostajesz limity wiadomości w oknach pięciogodzinnych i tygodniowych, a w środku korzystasz z modeli bez rozliczania pojedynczych rozmów. API odwraca tę logikę. Nie ma abonamentu, nie ma okien, jest portfel kredytów, z którego system ściąga stawkę za każdy milion tokenów wejścia i wyjścia, osobno dla każdego modelu. Wybierasz najtańszego Haiku do zadań masowych albo Fable do najtrudniejszych, i to wybór modelu, nie plan, decyduje o rachunku.

Ta różnica ma praktyczne konsekwencje dla dwóch grup ludzi. Programiści, którzy chcą wpiąć Claude we własną aplikację, automatyzację albo skrypt, nie mają wyjścia: subskrypcja nie udostępnia modelu z zewnątrz, API tak. Za to ci, którzy po prostu dużo rozmawiają z modelem w interfejsu, na API zwykle przepłacają, bo abonament wlicza bardzo dużo użycia w stałej cenie, a rozliczenie tokenowe rośnie liniowo z każdym zadaniem. Granica jest płynna i przesuwa się wraz z historią użycia, ale dla pojedynczej osoby pracującej w okienku czatu sensownym punktem startu jest subskrypcja, nie klucz API.

Typowe zastosowania łatwo rozpoznać po tym, że człowiek nie siedzi przy każdej odpowiedzi. Sklep wpiąć asystenta, który streszcza zgłoszenia klientów przed ręczną obsługą. Zespół analityczny puszcza przez model dziesiątki raportów i zbiera punkty w jedno miejsce. Deweloper stawia sobie pomocnika do przeglądu kodu, który komentuje pull requesty. We wszystkich tych wypadkach liczy się to, że model pracuje w czyimś rytmie, a nie w rytmie okienek limitów, i że rachunek rośnie dokładnie tak szybko jak faktyczne użycie. Subskrypcja do takich rzeczy się nie nadaje, bo nie ma jak się do niej dostać z zewnątrz.

Jest też trzecia droga, o której łatwo zapomnieć: kredyty API dokładowe. Od siódmego października plany Max i Team dostają comiesięczne kredyty API do wykorzystania poza limitami subskrypcji, więc można łączyć oba tryby na jednym koncie. To jednak mechanika planów płatnych, rozpisana w cenniku, a ten tekst dotyczy czystej ścieżki deweloperskiej od zera.

Konto w konsoli i kredyty

Centrum dowodzenia API nazywa się konsola Claude i mieszka pod adresem platform.claude.com; starsza nazwa console.anthropic.com wciąż krąży po sieci i przekierowuje w to samo miejsce. To osobne konto od konta czatowego: możesz mieć subskrypcję Pro na jednym i organizację deweloperską na drugim, z osobnym rozliczeniem. Po rejestracji konsola pokazuje sekcje ustawień, z których dwie będą cię interesować na starcie: billing, czyli portfel kredytów i limity wydatków, oraz API keys, czyli klucze.

Kredyty kupujesz z góry i z nich system rozlicza każde zapytanie. Minimalna kwota pierwszego zakupu nie jest nigdzie opublikowana w dokumentacji, którą czytałem, więc nie podam konkretnej liczby; także progi awansu między tierami limitów firma trzyma dla siebie i podnosi konta automatycznie na podstawie historii użycia. Do tego w ustawieniach rozliczeń ustawiasz własny miesięczny limit wydatków, poniżej capu tieru, co przy pierwszych eksperymentach jest rozsądne: lepiej dostać odmowę serwisu niż niespodziankę na karcie.

Organizacje nowo założone zaczynają w niższym tierze ewaluacyjnym z ograniczonymi limitami i awansują w miarę użycia. Z Polski płaci się kartą, rozliczenie jest w dolarach, więc dochodzi przewalutowanie według tabeli twojego banku, ta sama mechanika co przy subskrypcjach, o której pisaliśmy w cenniku.

Klucz API i jego bezpieczeństwo

Klucz generujesz w ustawieniach konta, w sekcji API keys. Przy tworzeniu konsola pyta o dwa parametry: typ klucza oraz czas wygaśnięcia. Klucz pokazuje się raz, przy wygenerowaniu, i potem już tylko jego nazwa oraz fragment pozostają widoczne w liście, więc zapisz go od razu do menedżera haseł albo sejfu, którym faktycznie się posługujesz. Osobna funkcja konsoli, workspaces, pozwala rozdzielić środowiska, na przykład projekt testowy od produkcyjnego, z osobnymi kluczami i osobną kontrolą wydatków, i jest to ta sama praktyka izolacji, którą stosuje się przy kluczach chmurowych.

Teraz część, którą jako specjalista od bezpieczeństwa muszę rozpisać dokładniej, bo wyciek klucza API to nie awaria kosmetyczna. Klucz wręczony osobie trzeciej oznacza, że ktoś inny płaci twoją kartą za swoje zapytania, a w jeszcze gorszym wariantcie, gdy klucz siedzi w publicznym repozytorium, boty skanujące GitHub znajdują go w minuty. Zasady są krótkie. Klucz trzymasz w zmiennej środowiskowej albo pliku poza repozytorium, dodanym do ignorowanych, nigdy w kodzie i nigdy w adresie URL, bo adresy lądują w logach. Biblioteki Anthropic czytają klucz ze zmiennej środowiskowej samodzielnie, więc nie ma powodu, by wchodził w kod choćby na chwilę. Klucze rotujesz, gdy podejrzewasz wyciek, a czas wygaśnięcia ustawiony przy tworzeniu działa jak siatka bezpieczeństwa: klucz tymczasowy, który sam umiera, jest lepszy niż wieczny.

Do testów bez pisania kodu służy playground w konsoli, okno w przeglądarce, w którym składasz zapytania i widzisz odpowiedzi oraz zużycie tokenów. Właśnie tam warto przejść pierwszą rozmowę, zanim wydasz pierwsze centy z kredytów w własnym skrypcie.

Pierwsze zapytanie krok po kroku

Sam protokół jest krótki i nie zmienił się zasadniczo od lat. Baza API to api.anthropic.com, a wiadomości wysyłasz metodą POST na ścieżkę /v1/messages. Nagłówki, których wymaga dokumentacja: autoryzacja oraz pole anthropic-version z wartością 2023-06-01 i content-type application/json. Autoryzacja przechodzi przez nagłówek Authorization z tokenem Bearer, a starszy wariant, nagłówek x-api-key z samym kluczem, wciąż działa i to on krąży w większości przykładów w sieci.

Ciało zapytania składa się z trzech wymaganych pól: model z identyfikatorem takim jak claude-sonnet-5-5, max_tokens z górną granicą długości odpowiedzi oraz messages, czyli listy wiadomości, z których każda ma rolę i treść. Wariant w curl, złożony z pól udokumentowanych w referencji:

Stylizowana ścieżka pierwszego zapytania Claude API: karty KONTO KONSOLI platform.claude.com, KREDYTY w sekcji billing, KLUCZ w sekcji API keys i ZAPYTANIE POST /v1/messages z polami model, max_tokens i messages, połączone kropkowaną linią z pomiarem zużycia tokenów na końcu
Ścieżka od konta konsoli do pierwszej odpowiedzi Claude API wg dokumentacji platform.claude.com z 13 października 2026. Ilustracja stylizowana.
curl https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{"model":"claude-sonnet-5-5","max_tokens":1024,
       "messages":[{"role":"user","content":"Cześć"}]}'

Ten sam kształt w Pythonie z oficjalną biblioteką, która sama ustawia nagłówki i czyta klucz ze zmiennej środowiskowej:

import anthropic

klient = anthropic.Anthropic()
odp = klient.messages.create(
    model="claude-sonnet-5-5",
    max_tokens=1024,
    messages=[{"role": "user", "content": "Cześć"}],
)
print(odp.content[0].text)

Odpowiedź wraca jako JSON z treścią wygenerowaną przez model i rozliczeniem zużycia, więc od pierwszego zapytania widzisz, ile tokenów naprawdę kosztuje twoje pytanie. Dookoła endpointu wiadomości stoi kilka pomocników: osobna ścieżka zlicza tokeny przed wysłaniem, więc możesz oszacować koszt bez wydawania kredytów, lista modeli podaje dostępne identyfikatory, a osobny endpoint zbiera zapytania w paczki wsadowe. Warto też wiedzieć, że pojedyncze zapytanie ma rozmiarowy sufit 32 megabajtów, a paczki wsadowe aż 256, więc granice dotyczą głównie bardzo dużych załączników.

Ile kosztuje: ceny za tokeny

Stawki API zależą od modelu i to jest najważniejsza decyzja kosztowa, jaką podejmujesz. Tabela stanu na trzynasty października, pełny przelicznik z przykładami w cenniku:

ModelWejście (USD/1M)Wyjście (USD/1M)
Haiku 5.50,100,50
Sonnet 5.5210
Opus 5.5420
Fable 5.11050

Rozpiętość od dziesięciu centów do pięćdziesięciu dolarów za milion tokenów oznacza, że ta sama rozmowa kosztuje na różnych modelach kilkadziesiąt razy różnie. Prompt dwóch tysięcy tokenów z odpowiedzią tysiąca to na Haiku 5.5 mniej niż jedna dziesiąta centa, na Sonnecie 5.5 około półtora centa, na Opusie 5.5 niecałe trzy, a na Fable 5.1 siedem centów. Haiku ma przy tym stawki dwuschodkowe: powyżej stu tysięcy tokenów w prompcie wchodzi droższy próg, bo długi kontekst kosztuje więcej. O premierze najtańszego modelu pisaliśmy przy okazji jego wejścia do cennika, bo to właśnie Haiku 5.5 spuścił próg wejścia do API Claude na poziom groszy.

Dookoła stawek bazowych stoi kilka mechanizmów, które potrafią przechylić rachunek w obie strony. Zapytania wsadowe, zbierane w paczki i odpytywane z opóźnieniem, kosztują o połowę mniej, więc wszystko, co nie musi wracać na żywo, opłaca się batchować. Zapis i odczyt pamięci podręcznej rozliczane są osobno i po październikowej obniżce odczyt na Sonnecie 5.5 kosztuje dziesięć centów za milion, co przy pracy agentowej, gdzie ten sam długi kontekst wraca w kolejnych krokach, zdejmuje realną część rachunku. Są też dopłaty: tryb fast na Opusie podwaja stawkę, inferencja wykonywana wyłącznie na serwerach w Stanach dokłada mnożnik 1,1, wyszukiwanie w internecie w API kosztuje 10 dolarów za tysiąc zapytań, a wykonywanie kodu ma pięćdziesiąt darmowych godzin dziennie na organizację, po czym płaci się 5 centów za godzinę kontenera.

Rachunek miesięczny robi się czytelny na prostej symulacji z tych stawek. Załóżmy automat, który dziennie obsługuje tysiąc krótkich rozmów po dwa tysiące tokenów wejścia i tysiąc wyjścia, czyli miesięcznie około sześćdziesięciu milionów tokenów wejścia i trzydziestu milionów wyjścia. Na Haiku 5.5 miesiąc takiej pracy kosztuje nieco ponad dwadzieścia dolarów, na Sonnecie 5.5 ponad czterysta, a na Opusie 5.5 ponad osiemset. Ta sama praca, trzy zupełnie budżety, i dlatego prototypy zaczyna się od najtańszego modelu, a droższy włącza się dopiero tam, gdzie jakość rzeczywiście robi różnicę. Przy pięćdziesięciu rozmowach dziennie zamiast tysiąca cała tabela spada o rząd wielkości i wtedy nawet Fable bywa do udźwignięcia.

Limity: tiery i okna

Oprócz portfela kredytów organizacja ma limity szybkości, pogrupowane w tiery o nazwach Start, Build, Scale i Custom. Tier Start ma cap wydatków 500 dolarów miesięcznie, Build 1000, Scale 200 tysięcy, a Custom ustalany jest indywidualnie. W tierze Start limit dla obecnych modeli rodziny Claude, od Haiku 4.5 po Opus 5.5, wynosi tysiąc zapytań na minutę, dwa miliony tokenów wejścia i czterysta tysięcy tokenów wyjścia na minutę; Fable, jako najdroższy model, ma własny, niższy limit. W tierze Build liczby rosną do pięciu tysięcy zapytań, pięciu milionów tokenów wejścia i miliona wyjścia, a w Scale do dziesięciu, dziesięciu i dwóch odpowiednio.

Awans między tierami nie ma opublikowanych progów wydatków: następuje automatycznie wraz z historią użycia albo po prośbie złożonej w konsoli. Gdy skończy się cap wydatków tieru, zapytania dostają błąd 429 z kodem enforced_spend_limit_reached i przechodzą bez nagłówka pokazującego czas ponowienia, a portfel odblokowuje się o północy UTC pierwszego dnia kolejnego miesiąca. Własny, niższy limit ustawiony w rozliczeniach działa podobnie i to najlepsza ochrona przed kosztami eksperymentów, które wymknęły się z rąk.

Limity liczone są dla całej organizacji, nie dla pojedynczego klucza, więc pięć kluczy w pięciu projektach dzieli jedną pulę zapytań na minutę i jeden portfel kredytów. Bieżące zużycie oraz numer tieru widać w konsoli w sekcji użycia, obok strony limitów, z której składa się też prośbę o podniesienie. Przy pracy zespołowej warto od razu przełączyć myślenie z licznika wiadomości na licznik tokenów: zapytanie, które w czacie było jedną wiadomością, w API to precyzyjnie odliczona ilość tekstu w obie strony, i to ona, nie liczba kliknięć, stanowi o wszystkim.

Najczęstsze pytania

Czy Claude API jest darmowe?

Nie ma darmowego tieru ani startowych kredytów, które można by wydać na zapytania. Sam klucz wygenerujesz bezpłatnie, playground w konsoli pozwala testować, ale każde zapytanie do modelu rozlicza się z kupionych kredytów, od pierwszego tokenu.

Jak zdobyć klucz API Claude?

Zakładasz konto w konsoli platform.claude.com, przechodzisz do ustawień, sekcja API keys, i generujesz klucz, wybierając przy okazji jego typ i czas wygaśnięcia. Klucz widoczny jest tylko raz, przy tworzeniu.

Ile kosztuje jedno zapytanie do Claude API?

Zależy wyłącznie od modelu i długości. Krótka rozmowa, dwa tysiące tokenów wejścia i tysiąc wyjścia, kosztuje na Haiku 5.5 ułamek centa, na Sonnecie 5.5 około półtora centa, na Fable 5.1 siedem centów. Długie rozmowy agentowe, ze stu tysiącami tokenów wyjścia, liczą się w dolarach za sztukę.

Jakie są limity zapytań?

Tiery Start, Build i Scale mają rosnące limity zapytań na minutę oraz tokenów wejścia i wyjścia na minutę, od tysiąca zapytań i dwóch milionów tokenów wejścia w tierze Start. Po przekroczeniu zapytania dostają błąd 429; po wyczerpaniu miesięcznego capu wydatków odblokowanie następuje o północy UTC pierwszego dnia kolejnego miesiąca.

Czy z Polski da się korzystać z Claude API?

Tak, Polska jest na liście krajów obsługiwanych, płatność kartą przechodzi w dolarach z przewalutowaniem wg tabeli banku, a w ustawieniach rozliczeń organizacji można dodać numer VAT i dostać dokumenty na firmę.

Nota uczciwości

Wszystkie ścieżki w konsoli, nagłówki, pola zapytania, tiery limitów i stawki pochodzą z dokumentacji platform.claude.com oraz cennika claude.com odczytanych trzynastego października 2026. Konta w konsoli nie zakładaliśmy, kredytów nie kupowaliśmy i żadnego zapytania na żywy model nie wykonaliśmy, więc przykłady zapytań to konstrukcje z pól udokumentowanych w referencji, a nie zrzuty z naszych sesji. Kwoty minimalnego zakupu kredytów i progi awansu tierów producent nie publikuje i świadomie tych liczb nie zgadujemy. Zmiany będziemy nanosić rewizjami tego artykułu.

Źródła

Powiązane artykuły