← Svi članci

Claude API: ključ, krajnja točka /v1/messages i odabir verzije modela

Claude API: ključ, krajnja točka /v1/messages i odabir verzije modela

Claude API je način na koji pozivate Claude modele iz vlastitog koda umjesto iz prozora za chat: bot za podršku na vašoj web-lokaciji, skripta koja triira tikete, dovršavanje koda u editoru, CRM integracija. Na NeuralSpaceu ključ se kreira na vašoj nadzornoj ploči za otprilike minutu, zahtjevi idu na krajnju točku POST /v1/messages kompatibilnu s Anthropicom, a vi plaćate iz tokena salda bez pretplate. Ispod je vodič korak po korak: kako dobiti ključ, kako izgleda vaš prvi poziv i kako odabrati verziju modela — Haiku, Sonnet, Opus ili Fable.

Što je Claude API i kako se razlikuje od chata

Claude je Anthropicova obitelj jezičnih modela. U prozoru za chat razgovarate s modelom ručno; putem API-ja vaš kod radi istu stvar: šalje niz poruka, dobiva generirani odgovor i koristi ga u vašem proizvodu — pokazuje ga korisniku, pohranjuje, dalje obrađuje. Tipični slučajevi upotrebe: botovi za podršku, sažimanje e-pošte i dokumenata, izdvajanje strukturiranih podataka, izrada sadržaja, automatizacija rutinskog rada u skriptama. Ključna razlika od chata je predvidljivost: sami postavljate upute sustava, ograničenje odgovora i verziju modela, a potrošnju vidite u tokenima.

Korak 1. Nabavite ključ

  1. Prijavite se za NeuralSpace svojom e-poštom — potrebno je manje od minute. Novi korisnici dobivaju početne tokene, dovoljno za prve zahtjeve bez nadoplate.
  2. OtvoriteStranica API ključevana nadzornoj ploči unesite naziv ključa (na primjer, "Moj bot") i kliknite Stvori.
  3. Ključ izgleda kao nsk-… i prikazuje se samo jednom — kopirajte ga izravno u upravitelj lozinki ili varijablu okruženja, a ne u kod vašeg repozitorija.
  4. Provjerite stanje: tekstualni modeli zahtijevaju najmanje 50 tokena na računu. Dopune se vrše na nadzornoj ploči, bez naknade za pretplatu.
The NeuralSpace API keys page: creating a key and the Claude quick start

Korak 2. Vaš prvi poziv na /v1/messages

Tekstualni modeli Claude žive na krajnjoj točki POST https://neuralspace.pro/v1/messages kompatibilnoj s Anthropicom. Tijelo nosi model, messages polje s user/assistant ulogama, ograničenjem odgovora max_tokens (1 do 32000) i izbornom system instrukcijom. Minimalni zahtjev za kovrče:

__NS1054_BLOK_8__

Odgovor se vraća u formatu Anthropic: tekst je u content[0].text, a stvarna potrošnja u polju usage. Provjeri autentičnost pomoću zaglavlja x-api-key: nsk-…; klijenti koji govore samo Bearer mogu umjesto toga koristiti Authorization: Bearer nsk-….

Korak 3. Uključite Anthropic SDK

Ako već imate kod na službenom Anthropic SDK-u, promijenite točno dvije vrijednosti — base_url i ključ:

__NS1054_BLOK_14__

Za sučelja za chat, strujanje pomaže: dodajte "stream": true i odgovor stiže u komadima preko događaja poslanih s poslužitelja, tako da korisnik vidi prve riječi prije nego što se generiranje završi.

Koju verziju modela izabrati

Javni katalog NeuralSpace ima četiri Claude verzije, a razlika između njih je omjer brzine i cijene u odnosu na dubinu razmišljanja. Cijene u nastavku izražene su u tokenima web-mjesta za milijun API tokena, s ulazom i izlazom koji se naplaćuju zasebno (u vrijeme pisanja; stope su promjenjive):

  • Claude Haiku 4.5(claude-haiku-4-5) — 41 / 213. Najbrži i najjeftiniji: klasifikacija, kratki odgovori, skupna obrada teksta, grubo označavanje.
  • Claude Sonet 5(claude-sonnet-5) — 152.5 / 767. Radni konj: kod, duge upute, kontekstno gust dijalog. Razumna zadana vrijednost.
  • Claude Opus 5(claude-opus-5) — 359 / 1794.5. Za teške zadatke: razmišljanje u više koraka, analiza velikih dokumenata, suptilna logika.
  • Claude basna 5(claude-fable-5) — 718 / 3589.5. Predvodnik za najzahtjevnije scenarije, gdje je kvaliteta važnija od cijene.

Praktično pravilo: počnite s Haikuom ili Sonetom i prebacite selektivno na Opus i Fable, samo tamo gdje prva dva stvarno ne uspijevaju. Verzija je postavljena jednim poljem model u zahtjevu, tako da ih možete usporediti na istom odzivniku.

Streaming, ograničenja i krajnje točke usluge

Dva ograničenja rano zbunjuju ljude: 60 zahtjeva po minuti po ključu i minimalni saldo od 50 tokena za tekstualne modele. Vaš trenutačni saldo dolazi s GET /v1/balance, a strojno čitljiv popis modela s aktualnim cijenama s GET /v1/models. Oba zahtijevaju ključ. Trenutni tečajevi uvijek su prikazani u tablici naStranica s dokumentacijom API-ja.

Claude API i MCP: spajanje na Claude Code

Isti ključ povezuje NeuralSpace s AI agentima kao MCP poslužiteljem: sam agent poziva generiranje chata, slika, videa i glazbe u ime vašeg računa. Za Claude Code to je jedna naredba:

__NS1054_BLOK_23__

Ako još ne trebate API, isti modeli dostupni su u sučelju — urazgovormožete odabrati Claudea i razgovarati bez koda, a ravnotežu dijele chat i API.

FAQ

Trebam li Anthropic račun ili stranu karticu?

Ne. Ključ se izdaje na vašoj nadzornoj ploči NeuralSpace i plaćate tokenima računa — bez pretplate i bez postavljanja naplate u oblaku.

Kako se /v1/messages razlikuje od /v1/chat/completions?

To su dva formata istog API-ja. /v1/messages odražava Anthropic Messages API (polja model, messages, system, max_tokens) i odgovara modelima Claude i Anthropic SDK. /v1/chat/completions je OpenAI format za GPT i Grok modele chata. Mijenjaju se samo adresa i struktura tijela.

Koliko košta Claude API poziv?

Samo za žetone koje stvarno koristite: Claude Sonnet 5 u vrijeme pisanja iznosi 152,5 tokena na milijun ulaza i 767 na milijun izlaza. Zahtjev od nekoliko tisuća tokena košta otprilike 1 ₽. Aktualne cijene su u GET /v1/models iu tablici dokumentacije.

Postoji li besplatna razina?

Na platformi nema besplatnih generacija. Novi korisnici dobivaju starter tokene, dovoljno za prva trčanja; nakon toga plaćate po tokenu bez naknade za pretplatu.