Documentazione

Documentazione

Chiave API Anthropic (Claude)

Crea una chiave API Anthropic Claude su platform.claude.com, alla voce Settings → API keys: la chiave inizia con sk-ant- ed è mostrata una sola volta. Con una chiave Kunavo puoi accedere agli stessi modelli Claude tramite l’SDK OpenAI o la Messages API nativa, senza un account Anthropic.

Per ottenere una chiave API Anthropic Claude, accedi alla Claude Console su platform.claude.com, apri Settings → API keys e fai clic su Create Key. Una chiave API Anthropic inizia con sk-ant- ed è mostrata una sola volta al momento della creazione. La console di Anthropic è stata spostata da console.anthropic.com a platform.claude.com e la pagina delle chiavi si trova ora all’indirizzo platform.claude.com/settings/keys. Una chiave API Anthropic autentica le richieste a https://api.anthropic.com con l’header x-api-key e un header anthropic-version, non con Authorization: Bearer. Le FAQ sui prezzi di Anthropic indicano che i nuovi utenti ricevono una piccola quantità di crediti gratuiti per provare l’API; non è previsto un piano gratuito oltre a quei crediti, quindi l’utilizzo dell’API Claude viene fatturato per token una volta esauriti i crediti iniziali.

Kunavo è un gateway API AI indipendente e compatibile con OpenAI: con un’unica chiave API e un saldo a consumo puoi accedere ai modelli Claude, GPT e di immagini, video e audio, senza bisogno di un account per ciascun fornitore. Una chiave API Kunavo inizia con sk-kn-, si crea su kunavo.com/app/keys e non richiede un account Anthropic. Kunavo offre Claude sia tramite l’endpoint compatibile con OpenAI https://api.kunavo.com/v1/chat/completions sia tramite l’endpoint Anthropic nativo https://api.kunavo.com/v1/messages: per usare Claude con l’SDK OpenAI ufficiale basta cambiare base_url. Kunavo è a consumo, con una ricarica minima di $10, e non offre crediti gratuiti ai nuovi account.

I dettagli del prodotto Anthropic riportati in questa pagina — indirizzo della console, percorso del menu, prefisso della chiave, header di autenticazione e politica sui crediti gratuiti — sono stati verificati l’ultima volta sulla documentazione API ufficiale di Anthropic il 31 agosto 2026.

Opzione A — una chiave API direttamente da Anthropic

Una chiave della Anthropic Console è la scelta giusta se il progetto utilizzerà esclusivamente modelli Claude. Anthropic fattura la chiave per token e supporta ogni funzionalità Claude dal giorno del suo rilascio.

  1. Vai su platform.claude.com e accedi. Il vecchio indirizzo console.anthropic.com ora reindirizza alla stessa console.
  2. Apri Settings → API keys (link diretto: platform.claude.com/settings/keys) e fai clic su Create Key. Le chiavi Anthropic iniziano con sk-ant-... e sono mostrate una sola volta.
  3. Aggiungi un metodo di pagamento in Billing. Anthropic concede ai nuovi utenti una piccola quantità di crediti gratuiti, poi fattura per token.
  4. Invia la chiave come x-api-key, insieme a un header anthropic-version.
# Anthropic direct — x-api-key, not Bearer
curl https://api.anthropic.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-sonnet-5",
    "max_tokens": 256,
    "messages": [{"role": "user", "content": "Hello, Claude"}]
  }'

Una conseguenza da tenere presente: una chiave Anthropic consente di accedere solo a Claude. Se un progetto usa anche modelli GPT, di immagini o video, servono un account, una chiave, un SDK e una fattura distinti per ciascun provider.

Opzione B — un’unica chiave Kunavo per Claude e tutto il resto

Kunavo offre Claude tramite un’API compatibile con OpenAI e la Messages API Anthropic nativa. Un’unica chiave sk-kn- consente di accedere a Claude e a tutti gli altri modelli del catalogo con un solo saldo ricaricato via Stripe, senza un account Anthropic.

Chiave della Anthropic ConsoleChiave Kunavo
ModelliSolo ClaudeClaude, GPT, immagini, video, audio
Endpointapi.anthropic.comapi.kunavo.com/v1
APIsMessages APIAPI compatibile con OpenAI + Messages API
Header di autenticazionex-api-keyAuthorization: Bearer
Account del providerAccount Anthropic richiestoNon richiesto
FatturazioneAnthropic, per tokenUn solo saldo ricaricato via Stripe
Formato della chiavesk-ant-...sk-kn-...
  1. Crea un account Kunavo ed effettua una ricarica di $10. Kunavo è a consumo e il saldo non scade mai.
  2. Genera una chiave su /app/keys. La chiave Kunavo è mostrata una sola volta: conservala in una variabile d’ambiente.
  3. Indica https://api.kunavo.com/v1 nell’SDK OpenAI e chiama uno slug Claude.

Chiave API Claude o chiave API Anthropic

Una «chiave API Anthropic» e una «chiave API Claude» sono la stessa credenziale, chiamata in due modi diversi. Anthropic è l’azienda, Claude è la famiglia di modelli e la chiave creata nella Claude Console autentica le chiamate all’API Claude. La differenza tra le due chiavi qui sotto riguarda la loro provenienza e i servizi a cui consentono di accedere:

  • Chiave della Anthropic Console (sk-ant-...) — creata su platform.claude.com/settings/keys. Una chiave della Anthropic Console consente di chiamare solo Claude e Anthropic la fattura per token.
  • Chiave Kunavo (sk-kn-...) — creata su kunavo.com/app/keys. Una chiave Kunavo consente di chiamare gli stessi modelli Claude tramite l’SDK OpenAI o la Messages API nativa, oltre ai modelli GPT, di immagini, video e audio, usando un unico saldo ricaricato via Stripe e senza un account Anthropic.

Chiamare Claude con Python

Mantieni l’SDK OpenAI ufficiale. Per completare la migrazione basta cambiare base_url e il nome del modello.

import os
from openai import OpenAI

client = OpenAI(
    api_key=os.environ["KUNAVO_API_KEY"],
    base_url="https://api.kunavo.com/v1",  # the only line that changes
)

resp = client.chat.completions.create(
    model="claude-sonnet-5",
    messages=[{"role": "user", "content": "Explain quicksort in one paragraph."}],
)
print(resp.choices[0].message.content)

Chiamare Claude con Node.js

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.KUNAVO_API_KEY,
  baseURL: "https://api.kunavo.com/v1",
});

const resp = await client.chat.completions.create({
  model: "claude-sonnet-5",
  messages: [{ role: "user", content: "Explain quicksort in one paragraph." }],
});
console.log(resp.choices[0].message.content);

Oppure chiama Claude con curl

curl https://api.kunavo.com/v1/chat/completions \
  -H "Authorization: Bearer $KUNAVO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "claude-sonnet-5",
    "messages": [{"role": "user", "content": "Hello, Claude"}]
  }'
Il formato nativo delle richieste Anthropic funziona con la stessa chiave Kunavo: invia una richiesta POST a /v1/messages — consulta il riferimento della Messages API.

La chiave API Claude non funziona

Una chiave API Claude che restituisce 401 authentication_error dipende quasi sempre da uno di cinque problemi: header errato per l’endpoint, chiave inviata a un endpoint a cui non è destinata, spazi o virgolette introdotti nella variabile d’ambiente, chiave revocata oppure URL di base errato per quella chiave.

La causa più comune è una mancata corrispondenza dell’header. L’API nativa di Anthropic richiede x-api-key e anthropic-version. Gli endpoint compatibili con OpenAI, incluso Kunavo, richiedono Authorization: Bearer. Una chiave sk-ant- funziona solo con api.anthropic.com, mentre una chiave sk-kn- funziona solo con api.kunavo.com.

SintomoCausa probabileCorrezione
401 unauthorizedLa chiave è errata, revocata o inviata con l’header sbagliato per quell’endpointCrea di nuovo la chiave su /app/keys e invia Authorization: Bearer sk-kn-…
402 insufficient_quotaIl saldo è esaurito oppure è stato raggiunto il limite di spesa per chiaveRicarica il saldo o aumenta il limite della chiave
model not foundSlug erratoUsa uno slug esatto, come claude-sonnet-5; consulta /models
429 rate limitTroppe richieste in un breve intervalloAttendi e riprova aumentando progressivamente il ritardo

Per ciascuno degli errori seguenti è disponibile un approfondimento dedicato con il JSON di errore esatto, tutte le cause note e le soluzioni da copiare e incollare: 401 invalid api key, 429 rate_limit_error, saldo crediti troppo basso / 402, 529 overloaded e model_not_found.

Usare l’API Claude senza carta di credito

Anthropic accetta le principali carte di credito per gli account standard dell’API Claude e riserva la fatturazione su richiesta ai clienti aziendali: per il percorso diretto, in pratica serve una carta.

È possibile ricaricare un saldo Kunavo anche senza carta, tramite uno dei seguenti metodi: ACH bank debit (US bank accounts, settles in 3–5 business days), Alipay (mainland China), WeChat Pay (mainland China), UPI (India), Pix (Brazil), iDEAL (Netherlands), Bancontact (Belgium), EPS (Austria), MB WAY (Portugal), Satispay (Italy), BLIK (Poland), Bacs Direct Debit (United Kingdom, settles in several business days), Pay by Bank (United Kingdom, Ireland and Finland), Crypto (stablecoins) (US-dollar checkouts). Kunavo stabilisce i prezzi delle ricariche in USD e Stripe effettua la conversione nella pagina di pagamento, così un acquirente brasiliano può scansionare un codice Pix e pagare in reais senza dover cercare una carta abilitata agli acquisti internazionali. Sono disponibili anche portafogli digitali collegati a carte, ma sono esclusi intenzionalmente da questo elenco: un portafoglio collegato a una carta non risolve il problema. Consulta l’elenco completo dei metodi nel riferimento sulla fatturazione.

Nessuno dei due percorsi è gratuito. Anthropic concede ai nuovi utenti una piccola quantità di crediti gratuiti, poi fattura per token. Kunavo non offre crediti gratuiti ai nuovi account e richiede una ricarica minima di $10 per iniziare. Chi cerca un accesso gratuito permanente all’API Claude non lo troverà in nessuno dei due percorsi.

Quale modello Claude usare

  • claude-haiku-4-5 — il più economico e veloce, per classificazioni e assistenza ad alto volume. Kunavo offre Claude Haiku 4.5 a $0.70 per 1M token di input e $3.50 per 1M token di output.
  • claude-sonnet-5 — il modello equilibrato per la maggior parte delle attività di ragionamento, recupero delle informazioni e programmazione: il Sonnet più recente, vicino a Opus nella programmazione e nelle attività agentiche. Kunavo offre Claude Sonnet 5 a $1.40 / $7.00 per 1M token, contro il prezzo di listino Anthropic di $2.00 / $10.00.
  • claude-sonnet-4-6 — il Sonnet precedente, per prompt già ottimizzati per questo modello. Kunavo offre Claude Sonnet 4.6 a $2.10 / $10.50 per 1M token.
  • claude-opus-5 — per ragionamento complesso e contesti lunghi. Kunavo offre Claude Opus 5 a $3.50 / $17.50 per 1M token, contro il prezzo di listino Anthropic di $5.00 / $25.00.
  • claude-fable-5 — il modello più capace di Anthropic, per il ragionamento di frontiera e gli agenti con orizzonti temporali lunghi, rilasciato il 1 settembre 2026. Kunavo lo offre a $7.00 / $35.00 per 1M token, contro il prezzo di listino Anthropic di $10.00 / $50.00. La versione precedente, claude-fable-5, è ancora disponibile alla stessa tariffa.
Per le tariffe dei singoli modelli e gli esempi dettagliati di costo, consulta la guida ai prezzi dell’API Claude.

Lista di controllo per la sicurezza delle chiavi API

  • Non esporre mai una chiave API sul lato client. Instrada ogni chiamata tramite un server sotto il controllo dello sviluppatore.
  • Usa una chiave API per progetto o ambiente, così puoi revocare una chiave divulgata senza interrompere tutto il resto.
  • Ruota le chiavi API ogni trimestre. Kunavo consente di mantenere attive più chiavi contemporaneamente, lasciando così un intervallo per completare la rotazione.

FAQ

Come posso ottenere una chiave API Anthropic Claude?

Per ottenere una chiave API Anthropic Claude, accedi alla Claude Console su platform.claude.com, apri Settings → API keys e fai clic su Create Key. Una chiave API Anthropic inizia con sk-ant- ed è mostrata una sola volta al momento della creazione, quindi va copiata e salvata subito. La console di Anthropic è stata spostata da console.anthropic.com a platform.claude.com e la pagina delle chiavi si trova all’indirizzo platform.claude.com/settings/keys. Una chiave API Anthropic autentica le richieste a https://api.anthropic.com usando l’header x-api-key insieme a un header anthropic-version, non un header Authorization: Bearer.

Una chiave API Anthropic è la stessa cosa di una chiave API Claude?

Una chiave API Anthropic e una chiave API Claude sono la stessa credenziale, chiamata in due modi diversi. Anthropic è l’azienda, Claude è la famiglia di modelli e la chiave creata nella Claude Console autentica le chiamate all’API Claude. Una chiave API Kunavo (sk-kn-...) è una credenziale diversa, fornita da un’altra azienda, che consente di accedere agli stessi modelli Claude, oltre che ai modelli GPT e multimediali, tramite un unico endpoint compatibile con OpenAI.

L’API Claude è gratuita?

L’API Claude non è gratuita in modo continuativo. Le FAQ sui prezzi di Anthropic indicano che i nuovi utenti ricevono una piccola quantità di crediti gratuiti per provare l’API; Anthropic non specifica l’importo e non offre un piano gratuito oltre a quei crediti. Una volta esauriti, l’utilizzo dell’API Claude viene quindi fatturato per token. Anche Kunavo non offre crediti gratuiti ai nuovi account: per iniziare, un account Kunavo richiede una ricarica minima di $10; il saldo non scade mai e le chiamate 4xx e 5xx non vengono mai fatturate.

Perché la mia chiave API Claude non funziona?

Una chiave API Claude che restituisce 401 authentication_error dipende quasi sempre da uno di cinque problemi: header errato per l’endpoint, chiave inviata a un endpoint a cui non è destinata, spazi o virgolette introdotti nella variabile d’ambiente, chiave revocata oppure URL di base errato. L’API nativa di Anthropic su api.anthropic.com richiede x-api-key e anthropic-version; gli endpoint compatibili con OpenAI richiedono Authorization: Bearer. Una chiave sk-ant- funziona solo con api.anthropic.com, mentre una chiave Kunavo sk-kn- funziona solo con api.kunavo.com.

Posso usare l’API Claude senza carta di credito?

Anthropic accetta le principali carte di credito per gli account standard dell’API Claude e riserva la fatturazione su richiesta ai clienti aziendali: per il percorso diretto, quindi, in pratica serve una carta. Kunavo può essere ricaricato senza carta tramite diversi metodi: ACH bank debit (US bank accounts, settles in 3–5 business days), Alipay (mainland China), WeChat Pay (mainland China), UPI (India), Pix (Brazil), iDEAL (Netherlands), Bancontact (Belgium), EPS (Austria), MB WAY (Portugal), Satispay (Italy), BLIK (Poland), Bacs Direct Debit (United Kingdom, settles in several business days), Pay by Bank (United Kingdom, Ireland and Finland), Crypto (stablecoins) (US-dollar checkouts). Kunavo stabilisce i prezzi delle ricariche in USD e Stripe effettua la conversione nella pagina di pagamento: così un acquirente brasiliano paga un prezzo in dollari in reais. Nessuno dei due percorsi offre accesso gratuito continuativo: usare Claude comporta il pagamento dei token in entrambi i casi.

Posso chiamare Claude con l’SDK OpenAI?

È possibile chiamare Claude con l’SDK OpenAI ufficiale tramite l’endpoint Kunavo compatibile con OpenAI. Indica base_url https://api.kunavo.com/v1 nell’SDK OpenAI, passa una chiave Kunavo come bearer token e imposta model su uno slug Claude, per esempio claude-sonnet-5. L’API di Anthropic su api.anthropic.com non accetta richieste di completamento chat nel formato OpenAI: per chiamare Claude direttamente servono l’SDK Anthropic o la Messages API nativa.

Qual è la differenza tra una chiave API Anthropic e una chiave API Kunavo?

Una chiave API Anthropic chiama solo i modelli Claude e viene fatturata da Anthropic. Una chiave API Kunavo chiama Claude e i modelli GPT, di immagini, video e audio tramite un’unica API compatibile con OpenAI, con fatturazione tramite un solo saldo ricaricato via Stripe. Per una chiave API Anthropic serve un account Anthropic; per una chiave API Kunavo no.

Con quale modello Claude dovrei iniziare?

Inizia con claude-sonnet-5, il modello equilibrato per la maggior parte delle attività di ragionamento, recupero delle informazioni e programmazione. Scegli claude-haiku-4-5 per classificazioni e assistenza ad alto volume e basso costo. Usa claude-opus-5 per il ragionamento complesso e ricorri a claude-fable-5, il modello più capace di Anthropic, solo per il ragionamento di frontiera e gli agenti con orizzonti temporali lunghi.

Quanto costa l'API Claude?

Anthropic fattura l’API Claude per token, con tariffe che variano in base alla fascia del modello: Claude Haiku 4.5 è il più economico e Claude Fable 5 il più costoso. Kunavo offre gli stessi modelli Claude a prezzi inferiori al listino Anthropic per tutti i modelli: Claude Opus 5 costa $3.50 / $17.50 per 1M token contro $5.00 / $25.00 di Anthropic, Claude Haiku 4.5 costa $0.70 / $3.50 contro $1.00 / $5.00 di Anthropic e Claude Sonnet 5 costa $1.40 / $7.00 contro la tariffa introduttiva $2.00 / $10.00 che Anthropic ha reso il proprio prezzo standard permanente il 31 agosto 2026.

Kunavo fa parte di Anthropic?

Kunavo è un gateway indipendente che rivende l’accesso a questi modelli. Kunavo non è Anthropic, Google o OpenAI e non addestra né ospita i modelli che offre.

Cos’è e cosa non è Kunavo

Kunavo è un gateway API AI indipendente e compatibile con OpenAI: con un’unica chiave API e un saldo a consumo puoi accedere ai modelli Claude, GPT e di immagini, video e audio, senza bisogno di un account per ciascun fornitore.

Kunavo è un gateway indipendente che rivende l’accesso a questi modelli. Kunavo non è Anthropic, Google o OpenAI e non addestra né ospita i modelli che offre.

La documentazione di Anthropic su platform.claude.com è la fonte autorevole per informazioni sui prodotti, sui prezzi e sulle politiche di Anthropic. Questa pagina riproduce la procedura pubblicata da Anthropic, indicando la data in cui è stata verificata ogni informazione, e affianca a essa l’alternativa Kunavo.

Prossimi passi