← Tutti gli articoli

API Claude: chiave, endpoint /v1/messages e scelta di una versione del modello

Una chiave di accesso digitale luminosa accanto a blocchi volumetrici di testo fluttuanti su uno sfondo scuro

L'API Claude è il modo in cui chiami i modelli Claude dal tuo codice invece che da una finestra di chat: un bot di supporto sul tuo sito, uno script che valuta i ticket, il completamento del codice in un editor, un'integrazione CRM. Su NeuralSpace viene creata una chiave nella tua dashboard in circa un minuto, le richieste vanno alla compatibilità Anthropic POST /v1/messages endpoint e paghi da un saldo token senza abbonamento. Di seguito è riportata una guida passo passo: come ottenere una chiave, come si presenta la tua prima chiamata e come scegliere una versione del modello: Haiku, Sonnet, Opus o Fable.

Cos'è l'API Claude e in cosa differisce dalla chat

Claude è la famiglia di modelli linguistici di Anthropic. In una finestra di chat parli manualmente con la modella; attraverso l'API il tuo codice fa la stessa cosa: invia una serie di messaggi, ottiene una risposta generata e la utilizza nel tuo prodotto: la mostra all'utente, la memorizza, la elabora ulteriormente. Casi d'uso tipici: supportare bot, riepilogare e-mail e documenti, estrarre dati strutturati, redigere contenuti, automatizzare il lavoro di routine negli script. La differenza fondamentale rispetto alla chat è la prevedibilità: imposti tu stesso le istruzioni del sistema, il limite di risposta e la versione del modello e vedi la spesa in token.

Passaggio 1. Ottieni una chiave

  1. Iscriviti a NeuralSpace con la tua email: ci vuole meno di un minuto. Ai nuovi utenti vengono accreditati i token iniziali, sufficienti per le prime richieste senza ricarica.
  2. Apri il Pagina Chiavi API nella dashboard, inserisci il nome della chiave (ad esempio "Il mio bot") e fai clic su Crea.
  3. La chiave sembra nsk-… e viene mostrato solo una volta: copialo direttamente in un gestore di password o in una variabile di ambiente, non nel codice del tuo repository.
  4. Controlla il tuo saldo: i modelli di testo richiedono almeno 50 token sul conto. Le ricariche avvengono nella dashboard, senza alcun costo di abbonamento.
La pagina delle chiavi API NeuralSpace: creazione di una chiave e guida rapida di Claude

Passaggio 2. La prima chiamata a /v1/messages

I modelli testuali di Claude vivono nella compatibilità antropica POST https://neuralspace.pro/v1/messages punto finale. Il corpo porta il modello, a messages matrice con user/assistant ruoli, il limite di risposta max_tokens (da 1 a 32000) e un opzionale system istruzione. Una richiesta di arricciatura minima:

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

La risposta ritorna in formato Anthropic: il testo è in content[0].text e la spesa effettiva è nel usage campo. Autenticarsi con x-api-key: nsk-… intestazione; possono utilizzare i client che parlano solo Bearer Authorization: Bearer nsk-… Invece.

Passaggio 3. Collega l'SDK Anthropic

Se hai già il codice sull'SDK Anthropic ufficiale, modifichi esattamente due valori: base_url e la chiave:

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)

Per le interfacce di chat, lo streaming aiuta: aggiungi "stream": true e la risposta arriva in blocchi tramite eventi inviati dal server, quindi l'utente vede le prime parole prima che la generazione finisca.

Quale versione del modello scegliere

Il catalogo pubblico di NeuralSpace ha quattro versioni di Claude e la differenza tra loro è l'equilibrio tra velocità e prezzo rispetto alla profondità del ragionamento. I prezzi seguenti sono espressi in token del sito per milione di token API, con input e output fatturati separatamente (al momento della stesura di questo articolo; le tariffe sono variabili):

  • ClaudeHaiku4.5 (claude-haiku-4-5) — 41 / 213. Il più rapido ed economico: classificazione, risposte brevi, elaborazione di testi in blocco, etichettatura approssimativa.
  • Claude Sonetto 5 (claude-sonnet-5) — 152,5 / 767. Il cavallo di battaglia: codice, lunghe istruzioni, dialoghi ricchi di contesto. Un default sensato.
  • Claude Opus 5 (claude-opus-5) — 359/1794,5. Per compiti difficili: ragionamento in più fasi, analisi di documenti di grandi dimensioni, logica sottile.
  • Claude Favola 5 (claude-fable-5) — 718 / 3589,5. Il fiore all'occhiello per gli scenari più esigenti, dove la qualità conta più del prezzo.

Una regola pratica: iniziare con Haiku o Sonetto e passare selettivamente a Opus e Fable, solo dove i primi due effettivamente non sono all'altezza. La versione è impostata da un singolo model nella richiesta, in modo da poterli confrontare nello stesso prompt.

Streaming, limiti ed endpoint del servizio

Due limiti fanno alzare presto le persone: 60 richieste al minuto per chiave e un saldo minimo di 50 token per i modelli di testo. Il tuo saldo attuale proviene da GET /v1/balancee un elenco leggibile dalla macchina di modelli con prezzi in tempo reale da GET /v1/models. Entrambi richiedono una chiave. Le tariffe attuali sono sempre riportate nella tabella sul Pagina della documentazione dell'API.

Claude API e MCP: collegarlo a Claude Code

La stessa chiave collega NeuralSpace agli agenti AI come un server MCP: l'agente stesso chiama la generazione di chat, immagini, video e musica per conto del tuo account. Per Claude Code è un comando:

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

Se non hai ancora bisogno dell'API, gli stessi modelli sono disponibili nell'interfaccia — in chiacchierata puoi scegliere Claude e parlare senza codice e il saldo è condiviso tra chat e API.

Domande frequenti

Ho bisogno di un conto Anthropic o di una carta estera?

No. La chiave viene emessa nella dashboard di NeuralSpace e paghi con i token dell'account, senza abbonamento e senza configurazione di fatturazione cloud.

In che modo /v1/messages è diverso da /v1/chat/completions?

Sono due formati della stessa API. /v1/messages rispecchia l'API Anthropic Messages (fields model, messages, system, max_tokens) e si adatta ai modelli Claude e all'SDK Anthropic. /v1/chat/completions è il formato OpenAI per i modelli di chat GPT e Grok. Cambia solo l'indirizzo e la struttura corporea.

Quanto costa una chiamata API Claude?

Solo per i token effettivamente utilizzati: Claude Sonnet 5 al momento in cui scrivo è di 152,5 token per milione di input e 767 per milione di output. Una richiesta di un paio di migliaia di token costa circa $ 0,01. I prezzi attuali sono presenti GET /v1/models e nella tabella della documentazione.

Esiste un livello gratuito?

Non ci sono generazioni libere sulla piattaforma. I nuovi utenti ricevono token iniziali, sufficienti per le prime esecuzioni; dopodiché paghi per token senza costi di abbonamento.