← Kaikki artikkelit

Claude API: avain, /v1/messages-päätepiste ja malliversion valinta

Hehkuva digitaalinen pääsyavain kelluvien tilavuustekstilohkojen vieressä tummalla taustalla

Claude API on tapa kutsua Claude-malleja omasta koodistasi chat-ikkunan sijaan: tukibot sivustollasi, komentosarja, joka laskee liput, koodin viimeistely editorissa, CRM-integraatio. NeuralSpacessa avain luodaan kojelautaan noin minuutissa, pyynnöt menevät Anthropic-yhteensopivaan POST /v1/messages päätepiste, ja maksat token-saldosta ilman tilausta. Alla on vaiheittaiset ohjeet: kuinka saat avaimen, miltä ensimmäinen puhelusi näyttää ja kuinka valitset malliversion – Haiku, Sonnet, Opus tai Fable.

Mikä Claude API on ja miten se eroaa chatista

Claude on Anthropicin kielimallien perhe. Chat-ikkunassa puhut mallin kanssa käsin; API:n kautta koodisi tekee saman: se lähettää joukon viestejä, saa luodun vastauksen ja käyttää sitä tuotteessasi – näyttää sen käyttäjälle, tallentaa sen ja käsittelee sitä edelleen. Tyypillisiä käyttötapauksia: tukibotit, sähköpostien ja asiakirjojen yhteenvedon tekeminen, strukturoidun datan purkaminen, sisällön luonnostelu, rutiinityön automatisointi skripteissä. Keskeinen ero chatiin on ennustettavuus: asetat itse järjestelmäkäskyn, vastausrajan ja malliversion ja näet kulutuksen tokeneina.

Vaihe 1. Hanki avain

  1. Rekisteröidy NeuralSpaceen sähköpostilla – se kestää alle minuutin. Uudet käyttäjät saavat aloitustunnukset, jotka riittävät ensimmäisiin pyyntöihin ilman lisäystä.
  2. Avaa API-avaimet -sivu kirjoita kojelautaan avaimen nimi (esimerkiksi "Oma botti") ja napsauta Luo.
  3. Avain näyttää nsk-… ja näkyy vain kerran – kopioi se suoraan salasanan hallintaan tai ympäristömuuttujaan, ei arkiston koodiin.
  4. Tarkista saldosi: tekstimalleissa tilillä on oltava vähintään 50 tokenia. Lisäykset tapahtuvat kojelaudassa ilman tilausmaksua.
NeuralSpace API -avainsivu: avaimen luominen ja Claude-pika-aloitus

Vaihe 2. Ensimmäinen puhelusi numeroon /v1/messages

Claude-tekstimallit elävät Anthropic-yhteensopivassa POST https://neuralspace.pro/v1/messages päätepiste. Keho kantaa mallia, a messages joukko kanssa user/assistant roolit, vastausraja max_tokens (1 - 32000) ja valinnainen system ohje. Pienin kiharapyyntö:

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?"}]
  }'

Vastaus tulee takaisin antrooppisessa muodossa: teksti on sisään content[0].text ja todellinen kulutus on usage ala. Todenna sovelluksella x-api-key: nsk-… otsikko; asiakkaat, jotka puhuvat vain kantajaa, voivat käyttää Authorization: Bearer nsk-… sen sijaan.

Vaihe 3. Liitä Anthropic SDK

Jos sinulla on jo koodi virallisessa Anthropic SDK:ssa, muutat täsmälleen kahta arvoa – base_url ja avain:

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)

Chat-käyttöliittymissä suoratoisto auttaa: add "stream": true ja vastaus saapuu paloina Palvelimen lähettämien tapahtumien kautta, joten käyttäjä näkee ensimmäiset sanat ennen sukupolven päättymistä.

Mikä malliversio valita

Julkisessa NeuralSpace-luettelossa on neljä Claude-versiota, ja ero niiden välillä on nopeuden ja hinnan tasapaino ja perustelujen syvyys. Alla olevat hinnat ovat sivustotunnuksia miljoonaa API-tunnusta kohden, ja syöttö ja tulos laskutetaan erikseen (kirjoitushetkellä; hinnat ovat kelluvia):

  • Claude Haiku 4.5 (claude-haiku-4-5) — 41 / 213. Nopein ja halvin: luokittelu, lyhyet vastaukset, joukkotekstinkäsittely, karkea merkintä.
  • Claude Sonnetti 5 (claude-sonnet-5) — 152,5 / 767. Työhevonen: koodi, pitkät ohjeet, kontekstiraskas dialogi. Järkevä oletusarvo.
  • Claude Opus 5 (claude-opus-5) — 359 / 1794,5. Vaikeisiin tehtäviin: monivaiheinen päättely, suuri asiakirja-analyysi, hienovarainen logiikka.
  • Claude Fable 5 (claude-fable-5) — 718 / 3589,5. Lippulaiva vaativimpiin skenaarioihin, joissa laatu on tärkeämpää kuin hinta.

Käytännön sääntö: aloita Haikusta tai Sonetista ja vaihda Opukseen ja Fableen valikoivasti, vain silloin, kun kaksi ensimmäistä todella jäävät vajaaksi. Version asettaa yksi model -kenttään pyynnössä, jotta voit verrata niitä samassa kehotteessa.

Suoratoisto, rajoitukset ja palvelun päätepisteet

Kaksi rajaa saa ihmiset ylös aikaisin: 60 pyyntöä minuutissa per avainta ja vähintään 50 merkkiä tekstimalleille. Nykyinen saldosi on peräisin GET /v1/balance, ja koneellisesti luettava luettelo malleista, joiden hinnat ovat alkaen GET /v1/models. Molemmat vaativat avaimen. Nykyiset hinnat näkyvät aina taulukossa API-dokumentaatiosivu.

Claude API ja MCP: yhdistäminen Claude Codeen

Sama avain yhdistää NeuralSpacen tekoälyagentteihin MCP-palvelimena: agentti itse kutsuu keskusteluja, kuvia, videoita ja musiikkia tilisi puolesta. Claude Codelle se on yksi komento:

claude mcp add --transport http neuralspace https://neuralspace.pro/mcp \
  --header "Authorization: Bearer nsk-your_key"

Jos et vielä tarvitse API:ta, samat mallit ovat saatavilla käyttöliittymässä – in keskustella voit valita Clauden ja puhua ilman koodia, ja tasapaino jaetaan chatin ja API:n välillä.

FAQ

Tarvitsenko Anthropic-tilin vai ulkomaisen kortin?

Ei. Avain myönnetään NeuralSpace-hallintapaneelissasi ja maksat tilitunnuksilla – ei tilausta eikä pilvilaskutusasetuksia.

Miten /v1/messages eroaa /v1/chat/completionsista?

Ne ovat saman API:n kaksi muotoa. /v1/messages heijastaa Anthropic Messages API:ta (kentät model, messages, system, max_tokens) ja sopii Claude-malleille ja Anthropic SDK:lle. /v1/chat/completions on OpenAI-muoto GPT- ja Grok-chat-malleille. Vain osoite ja kehon rakenne muuttuvat.

Kuinka paljon Claude API -puhelu maksaa?

Vain tosiasiallisesti käyttämillesi tokeneille: Claude Sonnet 5:ssä on kirjoitushetkellä 152,5 merkkiä miljoonaa syöttöä kohden ja 767 miljoonaa tulostetta. Parin tuhannen tokenin pyyntö maksaa noin 0,01 dollaria. Nykyiset hinnat ovat mukana GET /v1/models ja dokumentaatiotaulukossa.

Onko ilmaista tasoa?

Alustalla ei ole vapaita sukupolvia. Uudet käyttäjät saavat aloitustunnuksia, jotka riittää ensimmäisiin ajoihin; sen jälkeen maksat per token ilman tilausmaksua.