Claude API: klucz, punkt końcowy /v1/messages i wybór wersji modelu
Interfejs API Claude umożliwia wywoływanie modeli Claude z własnego kodu zamiast z okna czatu: bot wsparcia w Twojej witrynie, skrypt selekcjonujący zgłoszenia, uzupełnianie kodu w edytorze, integracja z CRM. W NeuralSpace klucz jest tworzony na pulpicie nawigacyjnym w ciągu około minuty, żądania trafiają do kompatybilnego z Anthropic POST /v1/messages punkcie końcowym i płacisz z salda tokenowego bez subskrypcji. Poniżej poradnik krok po kroku: jak zdobyć klucz, jak wygląda pierwsza rozmowa i jak wybrać wersję modelu — Haiku, Sonnet, Opus czy Fable.
Czym jest API Claude i czym różni się od czatu
Claude to rodzina modeli językowych firmy Anthropic. W oknie czatu rozmawiasz z modelem ręcznie; poprzez API Twój kod robi to samo: wysyła tablicę komunikatów, pobiera wygenerowaną odpowiedź i wykorzystuje ją w Twoim produkcie — pokazuje ją użytkownikowi, przechowuje, przetwarza dalej. Typowe przypadki użycia: wsparcie botów, podsumowywanie e-maili i dokumentów, wydobywanie ustrukturyzowanych danych, tworzenie treści, automatyzacja rutynowej pracy w skryptach. Kluczową różnicą od czatu jest przewidywalność: samodzielnie ustalasz instrukcje systemowe, limit odpowiedzi i wersję modelu, a wydatki widzisz w tokenach.
Krok 1. Zdobądź klucz
- Zarejestruj się w NeuralSpace, podając swój adres e-mail — zajmie to mniej niż minutę. Nowi użytkownicy otrzymują tokeny startowe, wystarczające na pierwsze żądania bez doładowania.
- Otwórz Strona kluczy API w swoim panelu wprowadź nazwę klucza (na przykład „Mój bot”) i kliknij Utwórz.
- Klucz wygląda
nsk-…i jest wyświetlany tylko raz — skopiuj go bezpośrednio do menedżera haseł lub zmiennej środowiskowej, a nie do kodu repozytorium. - Sprawdź saldo: modele tekstowe wymagają co najmniej 50 tokenów na koncie. Doładowania odbywają się w panelu kontrolnym, bez opłaty abonamentowej.

Krok 2. Twoje pierwsze wywołanie /v1/messages
Modele tekstowe Claude działają w wersji kompatybilnej z Anthropic POST https://neuralspace.pro/v1/messages punkt końcowy. Ciało nosi model, a messages tablica z user/assistant role, limit odpowiedzi max_tokens (1 do 32000) i opcjonalnie system instrukcja. Minimalne żądanie zwijania:
curl https://neuralspace.pro/v1/messages \
-H "x-api-key: nsk-your_key" \
-H "content-type: application/json" \
-d '{
"model": "claude-sonnet-5",
"max_tokens": 1024,
"system": "You answer technical questions briefly.",
"messages": [{"role": "user", "content": "How is streaming different from a regular response?"}]
}'Odpowiedź przychodzi w formacie antropicznym: tekst jest content[0].text a faktyczne wydatki są w usage pole. Uwierzytelnij się za pomocą x-api-key: nsk-… chodnikowiec; mogą korzystać klienci, którzy mówią tylko na okaziciela Authorization: Bearer nsk-… Zamiast.
Krok 3. Podłącz Anthropic SDK
Jeśli masz już kod w oficjalnym pakiecie Anthropic SDK, zmieniasz dokładnie dwie wartości — base_url i klucz:
from anthropic import Anthropic
client = Anthropic(
base_url="https://neuralspace.pro",
api_key="nsk-your_key",
)
resp = client.messages.create(
model="claude-sonnet-5",
max_tokens=1024,
system="You answer technical questions briefly.",
messages=[{"role": "user", "content": "Suggest three names for a channel about AI"}],
)
print(resp.content[0].text)W przypadku interfejsów czatu pomaga przesyłanie strumieniowe: dodaj "stream": true a odpowiedź przychodzi fragmentami poprzez zdarzenia wysyłane przez serwer, dzięki czemu użytkownik widzi pierwsze słowa przed zakończeniem generowania.
Którą wersję modelu wybrać
Publiczny katalog NeuralSpace zawiera cztery wersje Claude, a różnica między nimi polega na równowadze szybkości i ceny w stosunku do głębokości rozumowania. Poniższe ceny dotyczą tokenów witryny za milion tokenów API, przy czym dane wejściowe i wyjściowe są rozliczane osobno (w momencie pisania tego tekstu; stawki są zmienne):
- Klaudiusz Haiku 4.5 (
claude-haiku-4-5) — 41 / 213. Najszybciej i najtaniej: klasyfikacja, krótkie odpowiedzi, zbiorcze przetwarzanie tekstu, zgrubne etykietowanie. - Klaudiusz Sonnet 5 (
claude-sonnet-5) — 152,5 / 767. Koń pociągowy: kod, długie instrukcje, dialog oparty na kontekście. Rozsądne ustawienie domyślne. - Klaudiusz Opus 5 (
claude-opus-5) — 359/1794,5. Do trudnych zadań: wieloetapowe rozumowanie, analiza dużych dokumentów, subtelna logika. - Claude Bajka 5 (
claude-fable-5) — 718/3589,5. Flagowiec do najbardziej wymagających scenariuszy, gdzie jakość jest ważniejsza niż cena.
Praktyczna zasada: zacznij od Haiku lub Sonnet i przechodź selektywnie do Opus i Fable, tylko tam, gdzie pierwsze dwa rzeczywiście zawodzą. Wersja jest ustalana przez singiel model pole w żądaniu, dzięki czemu można je porównać w tym samym wierszu.
Przesyłanie strumieniowe, limity i punkty końcowe usług
Dwa limity powodują wcześniejsze wytrącenie ludzi z równowagi: 60 żądań na minutę na klucz i minimalne saldo 50 tokenów dla modeli tekstowych. Twoje obecne saldo pochodzi z GET /v1/balanceoraz czytelną maszynowo listę modeli z aktualnymi cenami z GET /v1/models. Obydwa wymagają klucza. Aktualne stawki są zawsze pokazane w tabeli na stronie Strona dokumentacji API.
Claude API i MCP: podłączenie do Claude Code
Ten sam klucz łączy NeuralSpace z agentami AI jako serwer MCP: sam agent wywołuje czat, generowanie obrazów, wideo i muzyki w imieniu Twojego konta. W przypadku Claude Code jest to jedno polecenie:
claude mcp add --transport http neuralspace https://neuralspace.pro/mcp \
--header "Authorization: Bearer nsk-your_key"Jeśli nie potrzebujesz jeszcze API, te same modele są dostępne w interfejsie – w pogawędzić możesz wybrać Claude'a i rozmawiać bez kodu, a saldo jest dzielone między czatem i API.
Często zadawane pytania
Czy potrzebuję konta Anthropic czy karty zagranicznej?
Nie. Klucz jest wydawany w panelu kontrolnym NeuralSpace i płacisz tokenami konta — bez subskrypcji i bez konfiguracji rozliczeń w chmurze.
Czym /v1/messages różni się od /v1/chat/completions?
Są to dwa formaty tego samego interfejsu API. /v1/messages odzwierciedla interfejs API Anthropic Messages (pola model, messages, system, max_tokens) i pasuje do modeli Claude i Anthropic SDK. /v1/chat/completions to format OpenAI dla modeli czatów GPT i Grok. Zmienia się tylko adres i struktura ciała.
Ile kosztuje połączenie z Claude API?
Tylko dla tokenów, których faktycznie używasz: Claude Sonnet 5 w momencie pisania tego tekstu wynosi 152,5 tokenów na milion danych wejściowych i 767 na milion wyników. Żądanie kilku tysięcy tokenów kosztuje około 0,01 dolara. Obowiązują aktualne ceny GET /v1/models oraz w tabeli dokumentacji.
Czy istnieje poziom bezpłatny?
Na platformie nie ma wolnych generacji. Nowi użytkownicy otrzymują tokeny startowe, wystarczające na pierwsze uruchomienia; następnie płacisz za token bez opłaty abonamentowej.