Claude API: klucz, ceny modeli w złotych i pierwsze zapytanie

👁 114 przeczytań

Claude API to sposób na używanie modeli Anthropic z własnego kodu: płacisz za tokeny, a nie za abonament, i sam decydujesz, który model obsługuje które zadanie. Klucz dostajesz w kilka minut w Console, pierwsze zapytanie to pięć linijek Pythona. Trudniejsza część to cennik: pięć modeli, cache promptów, tryb wsadowy i limity poziomów. Poniżej wszystko przeliczone na złote, z trzema scenariuszami kosztów i porównaniem z OpenAI i Gemini.

Czym jest Claude API i Console

Console (platform.claude.com) to panel dewelopera: tam zakładasz organizację, generujesz klucze, doładowujesz kredyty i widzisz zużycie. API to punkt końcowy api.anthropic.com, do którego Twój program wysyła wiadomości i dostaje odpowiedzi. To inne konto niż claude.ai: abonament Pro albo Max nie daje kredytów API i odwrotnie. Rozliczenie jest komercyjne, czyli dane z API nie są domyślnie używane do treningu modeli.

Claude Code działa w obu trybach: na abonamencie Pro/Max albo na kluczu API. Kiedy abonament, a kiedy API, policzyłem w tekście abonament czy API.

Konto, klucz i doładowanie krok po kroku

1. Załóż konto na platform.claude.com (mail albo konto Google) i podaj nazwę organizacji.
2. W zakładce API Keys kliknij „Create Key”, nadaj nazwę i skopiuj klucz od razu: Console pokazuje go tylko raz. Klucz trzymaj w zmiennej środowiskowej, nigdy w kodzie wrzucanym do repozytorium.
3. W Billing dodaj kartę i kup kredyty. Płatność jest z góry, w USD.
4. Sprawdź w Rate limits, na jakim jesteś poziomie.

Poziomy (tiers) nazywają się dziś Start, Build, Scale i Custom. Nowe organizacje mogą zaczynać od poziomu Evaluation z limitami niższymi niż standardowe, które rosną automatycznie wraz z historią użycia. Miesięczny limit wydatków: 500 USD na Start, 1000 USD na Build, 200 000 USD na Scale. Na poziomie Start Sonnet 5 ma limit 1000 zapytań i 2 mln tokenów wejścia na minutę, co dla małej aplikacji jest więcej niż dość.

Cennik w złotych

Stawki za milion tokenów z oficjalnej dokumentacji, kurs NBP 3,857 zł za dolara, bez VAT:

Trzy mechanizmy obniżają rachunek. Cache promptów: zapis do cache kosztuje 1,25 raza stawki wejścia (5 minut) albo 2 razy (godzina), odczyt 10 procent stawki, a w Opus 5.5 i Fable 5.1 jeszcze mniej. Opłaca się od pierwszego trafienia. Batch API: zapytania bez pośpiechu, przetwarzane w ciągu godzin, są o 50 procent tańsze na wejściu i wyjściu. Okno 1 mln tokenów w modelach od 4.6 wzwyż jest w standardowej cenie. Uwaga na tokenizer: modele od 4.7 wzwyż liczą ok. 30 procent więcej tokenów z tego samego tekstu niż Sonnet 4.6 i starsze. Wyszukiwanie w sieci kosztuje dodatkowo 10 USD za 1000 wyszukiwań.

Trzy scenariusze policzone z tabeli:

• Chatbot na stronie, 1000 rozmów miesięcznie po 3000 tokenów wejścia i 500 wyjścia na Sonnecie 5: 3 mln wejścia (6 USD) plus 0,5 mln wyjścia (5 USD) daje 11 USD, ok. 42 zł.
• Przetworzenie 500 dokumentów po 20 000 tokenów z tysiącem tokenów odpowiedzi na Haiku 4.5: 10 USD plus 2,50 USD, ok. 48 zł; w trybie wsadowym ok. 24 zł.
• Agent kodujący na Opus 5.5, 200 zadań po 100 000 tokenów kontekstu (80 procent z cache) i 5000 wyjścia: 16 USD za świeże wejście, 3,20 USD za odczyt z cache, 20 USD za wyjście, razem ok. 39 USD, czyli ok. 151 zł.

Pierwsze zapytanie: Python i curl

Ustaw klucz w zmiennej ANTHROPIC_API_KEY, zainstaluj bibliotekę poleceniem pip install anthropic i uruchom:

import anthropic

client = anthropic.Anthropic()
message = client.messages.create(
    model="claude-sonnet-5",
    max_tokens=500,
    messages=[{"role": "user", "content": "Streść w trzech zdaniach, czym jest RODO."}],
)
print(message.content[0].text)
print(message.usage)

To samo w curl:

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","max_tokens":500,
       "messages":[{"role":"user","content":"Streść w trzech zdaniach, czym jest RODO."}]}'

Pole usage w odpowiedzi podaje liczbę tokenów wejścia i wyjścia, więc koszt policzysz od razu. Najczęstsze błędy: 401 to zły klucz, 429 to przekroczony limit na minutę (nagłówek retry-after mówi, ile czekać) albo miesięczny limit wydatków, 400 z komunikatem o „specified API usage limits” to Twój własny limit z Billing. Zużycie w podziale na modele i klucze widzisz w zakładce Usage. Gdy chcesz dać modelowi narzędzia, przeczytaj tekst o budowaniu agentów z Claude API i MCP.

Claude API kontra OpenAI i Gemini API

Wszyscy trzej dają 50 procent zniżki w trybie wsadowym i cache promptów. Różnica jest w darmowym progu: Gemini ma stały darmowy poziom (z użyciem danych do ulepszania produktów), Anthropic i OpenAI nie. Opinia redakcji: przy podobnych cenach o wyborze decyduje jakość na Twoim zadaniu, nie cennik.

Najczęstsze pytania

Czy Claude API ma da[ją się używać darmowo?]rmowy limit?

Nowi użytkownicy dostają małą pulę darmowych kredytów na testy. Stałego darmowego poziomu, jak w Gemini API, nie ma.

Czy dane wysyłane przez API trenują model?

Nie, API działa na warunkach komercyjnych, bez treningu na danych klienta domyślnie. Standardowe przechowywanie to 30 dni, a firmy mogą negocjować zerowe.

Jak płacić z Polski i dostać fakturę?

Kartą, w dolarach, z góry. Faktury są w Console w zakładce Billing; firma może tam wpisać numer VAT UE. Jak rozliczyć taki zakup w polskiej księgowości, opisałem w tekście o płatnościach za narzędzia AI z zagranicy.

Który model wybrać na start?

Sonnet 5. Jest pięć razy tańszy od Fable 5.1 i wystarcza do większości zadań tekstowych. Haiku 4.5 bierz do klasyfikacji i masowego przetwarzania, Opus 5.5 do złożonego rozumowania i długich zadań agentowych. Więcej w tekście ile kosztuje Claude.