← Toate articolele

Claude API: cheie, punctul final /v1/messages și alegerea unei versiuni de model

O cheie de acces digital strălucitoare lângă blocuri volumetrice plutitoare de text pe un fundal întunecat

API-ul Claude este modul în care apelați modelele Claude din propriul cod în loc de o fereastră de chat: un bot de asistență pe site-ul dvs., un script care triajează biletele, completarea codului într-un editor, o integrare CRM. Pe NeuralSpace, o cheie este creată în tabloul de bord în aproximativ un minut, solicitările ajung la compatibil Anthropic POST /v1/messages punct final și plătiți dintr-un sold simbol fără abonament. Mai jos este un ghid pas cu pas: cum să obțineți o cheie, cum arată primul dvs. apel și cum să alegeți o versiune de model - Haiku, Sonnet, Opus sau Fable.

Ce este API-ul Claude și cum diferă de chat

Claude este familia Anthropic de modele de limbaj. Într-o fereastră de chat vorbești cu modelul manual; prin intermediul API-ului codul tău face același lucru: trimite o serie de mesaje, primește un răspuns generat și îl folosește în produsul tău — îl arată utilizatorului, îl stochează, îl procesează în continuare. Cazuri de utilizare tipice: roboți de asistență, rezumarea e-mail-urilor și documentelor, extragerea datelor structurate, redactarea conținutului, automatizarea lucrărilor de rutină în scripturi. Diferența cheie față de chat este predictibilitatea: setați singur instrucțiunile de sistem, limita de răspuns și versiunea modelului și vedeți cheltuiala în jetoane.

Pasul 1. Obțineți o cheie

  1. Înscrieți-vă la NeuralSpace cu e-mailul dvs. - durează mai puțin de un minut. Utilizatorii noi primesc jetoane de pornire creditate, suficiente pentru primele solicitări fără a se completa.
  2. Deschideți Pagina de chei API în tabloul de bord, introduceți un nume de cheie (de exemplu, „Botul meu”) și faceți clic pe Creare.
  3. Cheia arată ca nsk-… și este afișat o singură dată - copiați-l direct într-un manager de parole sau într-o variabilă de mediu, nu în codul dvs. de depozit.
  4. Verificați-vă soldul: modelele text necesită cel puțin 50 de jetoane în cont. Încărcările au loc în tabloul de bord, fără taxă de abonament.
Pagina de chei API NeuralSpace: crearea unei chei și pornirea rapidă Claude

Pasul 2. Primul dvs. apel la /v1/messages

Modelele text Claude trăiesc pe antropic-compatibil POST https://neuralspace.pro/v1/messages punct final. Corpul poartă modelul, a messages matrice cu user/assistant roluri, limita de răspuns max_tokens (1 la 32000) și un opțional system instrucție. O cerere minimă de bucle:

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

Răspunsul revine în format antropic: textul este în content[0].text iar cheltuielile reale sunt în usage domeniu. Autentificați-vă cu x-api-key: nsk-… antet; clienții care vorbesc doar Bearer pot folosi Authorization: Bearer nsk-… în schimb.

Pasul 3. Conectați SDK-ul Anthropic

Dacă aveți deja cod pe SDK-ul oficial Anthropic, modificați exact două valori — base_url si cheia:

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)

Pentru interfețele de chat, streaming ajută: adăugați "stream": true iar răspunsul ajunge în bucăți peste Evenimente trimise de server, astfel încât utilizatorul vede primele cuvinte înainte de terminarea generației.

Ce versiune de model să alegeți

Catalogul public NeuralSpace are patru versiuni Claude, iar diferența dintre ele este echilibrul dintre viteză și preț față de profunzimea raționamentului. Prețurile de mai jos sunt exprimate în jetoane de site per milion de jetoane API, cu intrare și ieșire facturate separat (la momentul scrierii, tarifele sunt variabile):

  • Claude Haiku 4.5 (claude-haiku-4-5) — 41 / 213. Cele mai rapide și mai ieftine: clasificare, răspunsuri scurte, procesare de text în bloc, etichetare brută.
  • Claude Sonetul 5 (claude-sonnet-5) — 152,5 / 767. Calul de bătaie: cod, instrucțiuni lungi, dialog greoi de context. O implicită sensibilă.
  • Claude Opus 5 (claude-opus-5) — 359 / 1794.5. Pentru sarcini grele: raționament în mai mulți pași, analiză de documente mari, logică subtilă.
  • Claude Fable 5 (claude-fable-5) — 718 / 3589,5. Nava emblematică pentru cele mai solicitante scenarii, în care calitatea contează mai mult decât prețul.

O regulă practică: începeți cu Haiku sau Sonnet și treceți la Opus și Fable selectiv, doar acolo unde primele două sunt cu adevărat scurte. Versiunea este stabilită de un singur model câmp din cerere, astfel încât să le puteți compara la același prompt.

Streaming, limite și puncte finale de serviciu

Două limite determină oamenii devreme: 60 de solicitări pe minut per cheie și un sold minim de 50 de jetoane pentru modelele text. Soldul tău actual provine din GET /v1/balance, și o listă de modele care poate fi citită de mașină cu prețuri live de la GET /v1/models. Ambele necesită o cheie. Tarifele curente sunt întotdeauna afișate în tabelul de pe Pagina de documentație API.

Claude API și MCP: conectarea la Claude Code

Aceeași cheie conectează NeuralSpace la agenții AI ca un server MCP: agentul însuși apelează generarea de chat, imagini, videoclipuri și muzică în numele contului tău. Pentru Claude Code este o singură comandă:

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

Dacă nu aveți nevoie încă de API, aceleași modele sunt disponibile în interfață - în chat îl poți alege pe Claude și vorbi fără cod, iar soldul este împărțit între chat și API.

FAQ

Am nevoie de un cont Anthropic sau de un card străin?

Nu. Cheia este emisă în tabloul de bord NeuralSpace și plătiți cu jetoane de cont - fără abonament și fără configurare de facturare în cloud.

Prin ce diferă /v1/messages de /v1/chat/completions?

Sunt două formate ale aceluiași API. /v1/messages reflectă API-ul Anthropic Messages (câmpurile model, messages, system, max_tokens) și se potrivește modelelor Claude și SDK-ului antropic. /v1/chat/completions este formatul OpenAI pentru modelele de chat GPT și Grok. Se schimbă doar adresa și structura corpului.

Cât costă un apel Claude API?

Doar pentru jetoanele pe care le utilizați efectiv: Claude Sonnet 5 la momentul scrierii este de 152,5 jetoane per milion de intrare și 767 per milion de ieșire. O solicitare de câteva mii de jetoane costă aproximativ 0,01 USD. Prețurile actuale sunt în GET /v1/models și în tabelul de documentație.

Există un nivel gratuit?

Nu există generații libere pe platformă. Utilizatorii noi primesc jetoane de pornire, suficiente pentru primele rulări; după aceea plătiți pe token fără taxă de abonament.