Home / Documentazione

Documentazione API Anthropic: la documentazione API Anthropic per il gateway API Claude

L'API Anthropic, documentata per il gateway AI Prime Tech: le stesse Messages API e gli stessi ID dei modelli, un unico URL di base e un'unica chiave, dalla prima richiesta con curl al rafforzamento per la produzione. Sono disponibili tutti i modelli Claude attuali.

curl https://claudeapikey.dev/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": 1024,
       "messages": [{"role": "user", "content": "Hello, Claude"}]}'

Inizia in quattro passaggi

  1. Crea un account e genera una chiave API nella dashboard.
  2. Imposta ANTHROPIC_BASE_URL sull'host del gateway e ANTHROPIC_API_KEY sulla tua chiave: l'SDK aggiunge /v1/messages automaticamente.
  3. Invia una richiesta nel formato Anthropic (/v1/messages) o nel formato OpenAI (/v1/chat/completions).
  4. Scegli un ID modello da GET /v1/models; cambia modello modificando una sola stringa.
Avvio rapidoPrima richiesta in circa un minutoClaude CodeDue variabili d'ambienteModelliID, finestre di contesto, tariffeRiferimento APIEndpoint e schemi

Per iniziare

IntroduzioneCos'è AI Prime Tech, quali endpoint supporta e in cosa differisce dalle chiamate dirette ad Anthropic.Avvio rapidoOttieni una chiave, imposta due variabili d'ambiente ed effettua la tua prima richiesta in circa un minuto.AutenticazioneCome inviare la chiave, quale header richiede ciascun formato e come proteggere le chiavi.Modelli e gruppi di chiaviVerifica i modelli disponibili per la tua chiave API, scegli il gruppo giusto e consulta i prezzi attuali dei modelli.URL di baseL'impostazione che mette tutti in difficoltà: quale URL si aspetta ogni client, con e senza il suffisso /v1.La tua prima richiesta spiegataUna spiegazione riga per riga di una chiamata Messages: cosa fa ogni campo e cosa viene restituito.

Riferimento API

Panoramica dell'APITutti gli endpoint esposti dal gateway, il formato che utilizzano e ciò che restituiscono.API MessagesPOST /v1/messages — l'endpoint in formato Anthropic: parametri, struttura della risposta ed esempi.API Chat CompletionsPOST /v1/chat/completions — l'endpoint in formato OpenAI, per Cursor, LangChain, LiteLLM e gli SDK OpenAI.Endpoint dei modelliGET /v1/models — scopri esattamente quali ID di modello può chiamare la tua chiave.StreamingEventi inviati dal server in entrambi i formati: le strutture degli eventi sono diverse e confonderle dà l'impressione che non arrivi nulla.ErroriTutti i codici di stato restituiti dal gateway, le loro cause effettive e come risolverle.Limiti di frequenzaCome funziona la limitazione delle richieste, cosa significa un 429 in questo contesto e come creare un client che non lo provochi.Uso degli strumenti e chiamata di funzioniConsenti a un modello di chiamare le tue funzioni: il ciclo delle richieste, entrambi i formati e gli errori che costano token.Visione e input di immaginiInvia immagini ai modelli multimodali: codifica, limiti di dimensione e costi.

Guide all'integrazione

Claude CodeCollega l'agente CLI di Anthropic al gateway con due variabili d'ambiente ed evita l'insidia che addebita silenziosamente i costi alla chiave sbagliata.CursorUsa i modelli Claude in Cursor tramite l'endpoint compatibile con OpenAI, senza un account Anthropic.ClineConfigura l'estensione Cline per VS Code per usare l'endpoint in formato Anthropic.AiderEsegui l'assistente di programmazione in coppia da terminale tramite il gateway, con uno qualsiasi dei due formati di comunicazione.ZedAggiungi il gateway come provider personalizzato di assistenti nell'editor Zed.ContinueConfigura l'estensione Continue per VS Code e JetBrains.Estensioni per VS CodeQuali estensioni AI per VS Code accettano un URL di base personalizzato e come collegare ciascuna al gateway.IDE JetBrainsIntelliJ IDEA, PyCharm, WebStorm, GoLand e gli altri: tramite Continue o un plugin compatibile con OpenAI.OpenCodeCollega l'agente di programmazione open source da terminale al gateway.Codex CLIEsegui la CLI Codex di OpenAI e l'estensione Codex per IDE tramite il gateway, con modelli GPT o Claude.OpenClawConfigura il framework per agenti OpenClaw per usare i modelli del gateway.Server MCP per Claude CodeUna configurazione di Model Context Protocol che merita il suo posto, insieme alle insidie che fanno perdere tempo prezioso.Configurazione della chiave API per strumentoSeleziona il gruppo di chiavi corretto, poi usa la chiave e l'URL di base richiesti dal tuo client.

Lavorare con l'API

Controllo dei costiDove vengono effettivamente consumati i token in un carico di lavoro con agenti e le quattro leve che incidono sui costi.Caching dei promptRileggi un prefisso stabile a una frazione del prezzo di input: cosa memorizzare nella cache, cosa escludere e come verificare che abbia funzionato.Gestione del contestoPerché il costo delle sessioni lunghe cresce in modo non lineare e quali strategie mantengono limitata la cronologia.Migrazione dall'API AnthropicMigra una base di codice esistente che usa l'SDK Anthropic modificando due valori.Migrazione dall'API OpenAIMantieni l'SDK OpenAI e accedi ai modelli Claude modificando l'URL di base.Best practice per la produzioneCosa sistemare prima che un'integrazione gestisca traffico reale.Risoluzione dei problemiIndice organizzato per sintomi: trova ciò che stai riscontrando e passa direttamente alla causa.

SDK

Panoramica degli SDKGli SDK ufficiali di Anthropic e OpenAI funzionano entrambi senza modifiche: scegli in base al formato che preferisci.PythonEsempi funzionanti con i pacchetti anthropic e openai, con streaming e chiamate asincrone.TypeScriptEsempi Node con @anthropic-ai/sdk e openai, con streaming.cURLEsempi senza dipendenze per ogni endpoint, utili per il debug e i controlli CI.GoChiama il gateway da Go con la libreria standard, senza bisogno di un client di terze parti.

Fatturazione

PrezziCome i crediti si convertono in token, quali sono i bonus e come calcolare il costo di un'attività.CreditiCome funziona il saldo prepagato, cosa lo consuma e come evitare di esaurirlo durante un'esecuzione.Piani illimitatiAccesso a tariffa fissa per un periodo definito: cosa include e quando conviene rispetto ai crediti.Metodi di pagamentoCarta e criptovalute: quale metodo usare e perché il bonus è diverso.Rimborsi e assistenzaCosa è rimborsabile, cosa non lo è e come segnalare un problema di fatturazione.

Risorse

FAQRisposte dirette alle domande che ci vengono effettivamente poste.GlossarioI termini usati in questa documentazione, definiti con precisione.Sicurezza e privacyCome gestire le chiavi, cosa evitare di inviare e i limiti di questo servizio.Registro delle modificheModifiche rilevanti alle funzionalità esposte dall'API, ai modelli e alla documentazione.Stato e affidabilitàCome il gateway gestisce i guasti dei servizi a monte e cosa fare quando il servizio è degradato.Disponibilità e metodi di pagamentoDove si può usare il servizio e come pagare quando i circuiti delle carte non sono disponibili.

Impara

Guide esplicative per gli acquirenti che affiancano la documentazione tecnica.

Cosa significa un'API compatibile con AnthropicSDK Python di Anthropic: installazione, base_url, streaming, asincronia e gestione degli errori (2026)Acquistare crediti API Claude: guida alla ricarica e alla configurazioneIl modo più economico per usare l'API ClaudeErrore del server Claude? Tutti gli errori dell'API Claude spiegati — 400, limite di frequenza 429, 500, sovraccarico 529 e come risolverliChiave API Claude gratuita? Cosa è davvero gratuito — API Claude gratuita, crediti di prova e l'opzione reale più economica (2026)Guida all'integrazione dell'API Claude: SDK, REST e pattern per la produzioneI modelli Claude spiegati 2026 — Confronto dei modelli Claude: Claude Opus, Sonnet, Haiku e Fable, nomi e prezzi dei modelli AnthropicI prezzi dell'API Claude spiegatiGateway API Claude e accesso diretto ad Anthropic a confrontoAPI Claude e abbonamento Claude Pro/Max a confronto — Quale sceglierePagare l'API Claude con criptovaluteAccesso all'API Claude senza lista d'attesaI prezzi di Claude Code spiegati: costi API, piani e come ridurliChiave API Claude Code (2026) — ANTHROPIC_API_KEY: come ottenerla, claude setup-token, token OAuth e chiave di sessione a confrontoAPI Claude Code: come funzionano chiavi, URL di base e fatturazione (2026)Come ottenere un utilizzo illimitato di Claude: piani e limitiCome ottenere una chiave API Claude: configurazione della console e del gatewayCome ridurre l'utilizzo dei token di ClaudeAPI Claude compatibile con OpenAI: usare Claude con l'SDK OpenAI (base_url, streaming, strumenti) (2026)Hermes Agent con Claude sulla propria API: config.yaml del provider personalizzato e controlli dei costi (2026)Eseguire OpenClaw senza limiti con ClaudeAPI Claude illimitata: copertura e limiti di utilizzo correttoCome ottenere una chiave API Claude illimitata

Tutti i 45 articoli della sezione Approfondimenti →

Guide a Codex e all'API GPT: Chiave API e accesso a Codex · API compatibile con OpenAI · Configurazione di Codex CLI · Confronto tra modelli GPT-6