Source: https://aiprimetech.io/it/docs/ [Home](/it/) / 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 - Crea un account e genera una chiave API nella dashboard. - Imposta ANTHROPIC_BASE_URL sull'host del gateway e ANTHROPIC_API_KEY sulla tua chiave: l'SDK aggiunge /v1/messages automaticamente. - Invia una richiesta nel formato Anthropic (/v1/messages) o nel formato OpenAI (/v1/chat/completions). - Scegli un ID modello da GET /v1/models; cambia modello modificando una sola stringa. [Avvio rapidoPrima richiesta in circa un minuto](/it/docs/getting-started/quickstart/)[Claude CodeDue variabili d'ambiente](/it/docs/guides/claude-code/)[ModelliID, finestre di contesto, tariffe](/it/docs/getting-started/models/)[Riferimento APIEndpoint e schemi](/it/docs/api-reference/overview/) ## Per iniziare [IntroduzioneCos'è AI Prime Tech, quali endpoint supporta e in cosa differisce dalle chiamate dirette ad Anthropic.](/it/docs/getting-started/introduction/)[Avvio rapidoOttieni una chiave, imposta due variabili d'ambiente ed effettua la tua prima richiesta in circa un minuto.](/it/docs/getting-started/quickstart/)[AutenticazioneCome inviare la chiave, quale header richiede ciascun formato e come proteggere le chiavi.](/it/docs/getting-started/authentication/)[Modelli e gruppi di chiaviVerifica i modelli disponibili per la tua chiave API, scegli il gruppo giusto e consulta i prezzi attuali dei modelli.](/it/docs/getting-started/models/)[URL di baseL'impostazione che mette tutti in difficoltà: quale URL si aspetta ogni client, con e senza il suffisso /v1.](/it/docs/getting-started/base-urls/)[La tua prima richiesta spiegataUna spiegazione riga per riga di una chiamata Messages: cosa fa ogni campo e cosa viene restituito.](/it/docs/getting-started/first-request/) ## Riferimento API [Panoramica dell'APITutti gli endpoint esposti dal gateway, il formato che utilizzano e ciò che restituiscono.](/it/docs/api-reference/overview/)[API MessagesPOST /v1/messages — l'endpoint in formato Anthropic: parametri, struttura della risposta ed esempi.](/it/docs/api-reference/messages/)[API Chat CompletionsPOST /v1/chat/completions — l'endpoint in formato OpenAI, per Cursor, LangChain, LiteLLM e gli SDK OpenAI.](/it/docs/api-reference/chat-completions/)[Endpoint dei modelliGET /v1/models — scopri esattamente quali ID di modello può chiamare la tua chiave.](/it/docs/api-reference/models-endpoint/)[StreamingEventi inviati dal server in entrambi i formati: le strutture degli eventi sono diverse e confonderle dà l'impressione che non arrivi nulla.](/it/docs/api-reference/streaming/)[ErroriTutti i codici di stato restituiti dal gateway, le loro cause effettive e come risolverle.](/it/docs/api-reference/errors/)[Limiti di frequenzaCome funziona la limitazione delle richieste, cosa significa un 429 in questo contesto e come creare un client che non lo provochi.](/it/docs/api-reference/rate-limits/)[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.](/it/docs/api-reference/tool-use/)[Visione e input di immaginiInvia immagini ai modelli multimodali: codifica, limiti di dimensione e costi.](/it/docs/api-reference/vision/) ## 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.](/it/docs/guides/claude-code/)[CursorUsa i modelli Claude in Cursor tramite l'endpoint compatibile con OpenAI, senza un account Anthropic.](/it/docs/guides/cursor/)[ClineConfigura l'estensione Cline per VS Code per usare l'endpoint in formato Anthropic.](/it/docs/guides/cline/)[AiderEsegui l'assistente di programmazione in coppia da terminale tramite il gateway, con uno qualsiasi dei due formati di comunicazione.](/it/docs/guides/aider/)[ZedAggiungi il gateway come provider personalizzato di assistenti nell'editor Zed.](/it/docs/guides/zed/)[ContinueConfigura l'estensione Continue per VS Code e JetBrains.](/it/docs/guides/continue/)[Estensioni per VS CodeQuali estensioni AI per VS Code accettano un URL di base personalizzato e come collegare ciascuna al gateway.](/it/docs/guides/vscode-extensions/)[IDE JetBrainsIntelliJ IDEA, PyCharm, WebStorm, GoLand e gli altri: tramite Continue o un plugin compatibile con OpenAI.](/it/docs/guides/jetbrains/)[OpenCodeCollega l'agente di programmazione open source da terminale al gateway.](/it/docs/guides/opencode/)[Codex CLIEsegui la CLI Codex di OpenAI e l'estensione Codex per IDE tramite il gateway, con modelli GPT o Claude.](/it/docs/guides/codex-cli/)[OpenClawConfigura il framework per agenti OpenClaw per usare i modelli del gateway.](/it/docs/guides/openclaw/)[Server MCP per Claude CodeUna configurazione di Model Context Protocol che merita il suo posto, insieme alle insidie che fanno perdere tempo prezioso.](/it/docs/guides/mcp-servers/)[Configurazione della chiave API per strumentoSeleziona il gruppo di chiavi corretto, poi usa la chiave e l'URL di base richiesti dal tuo client.](/it/docs/guides/api-key-configuration/) ## 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.](/it/docs/guides/cost-control/)[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.](/it/docs/guides/prompt-caching/)[Gestione del contestoPerché il costo delle sessioni lunghe cresce in modo non lineare e quali strategie mantengono limitata la cronologia.](/it/docs/guides/context-management/)[Migrazione dall'API AnthropicMigra una base di codice esistente che usa l'SDK Anthropic modificando due valori.](/it/docs/guides/migration-from-anthropic/)[Migrazione dall'API OpenAIMantieni l'SDK OpenAI e accedi ai modelli Claude modificando l'URL di base.](/it/docs/guides/migration-from-openai/)[Best practice per la produzioneCosa sistemare prima che un'integrazione gestisca traffico reale.](/it/docs/guides/best-practices/)[Risoluzione dei problemiIndice organizzato per sintomi: trova ciò che stai riscontrando e passa direttamente alla causa.](/it/docs/guides/troubleshooting/) ## SDK [Panoramica degli SDKGli SDK ufficiali di Anthropic e OpenAI funzionano entrambi senza modifiche: scegli in base al formato che preferisci.](/it/docs/sdks/)[PythonEsempi funzionanti con i pacchetti anthropic e openai, con streaming e chiamate asincrone.](/it/docs/sdks/python/)[TypeScriptEsempi Node con @anthropic-ai/sdk e openai, con streaming.](/it/docs/sdks/typescript/)[cURLEsempi senza dipendenze per ogni endpoint, utili per il debug e i controlli CI.](/it/docs/sdks/curl/)[GoChiama il gateway da Go con la libreria standard, senza bisogno di un client di terze parti.](/it/docs/sdks/go/) ## Fatturazione [PrezziCome i crediti si convertono in token, quali sono i bonus e come calcolare il costo di un'attività.](/it/docs/billing/pricing/)[CreditiCome funziona il saldo prepagato, cosa lo consuma e come evitare di esaurirlo durante un'esecuzione.](/it/docs/billing/credits/)[Piani illimitatiAccesso a tariffa fissa per un periodo definito: cosa include e quando conviene rispetto ai crediti.](/it/docs/billing/plans/)[Metodi di pagamentoCarta e criptovalute: quale metodo usare e perché il bonus è diverso.](/it/docs/billing/payment-methods/)[Rimborsi e assistenzaCosa è rimborsabile, cosa non lo è e come segnalare un problema di fatturazione.](/it/docs/billing/refunds/) ## Risorse [FAQRisposte dirette alle domande che ci vengono effettivamente poste.](/it/docs/resources/faq/)[GlossarioI termini usati in questa documentazione, definiti con precisione.](/it/docs/resources/glossary/)[Sicurezza e privacyCome gestire le chiavi, cosa evitare di inviare e i limiti di questo servizio.](/it/docs/resources/security/)[Registro delle modificheModifiche rilevanti alle funzionalità esposte dall'API, ai modelli e alla documentazione.](/it/docs/resources/changelog/)[Stato e affidabilitàCome il gateway gestisce i guasti dei servizi a monte e cosa fare quando il servizio è degradato.](/it/docs/resources/status/)[Disponibilità e metodi di pagamentoDove si può usare il servizio e come pagare quando i circuiti delle carte non sono disponibili.](/it/docs/resources/supported-countries/) ## Impara Guide esplicative per gli acquirenti che affiancano la documentazione tecnica. [Cosa significa un'API compatibile con Anthropic](/it/learn/anthropic-compatible-api/)[SDK Python di Anthropic: installazione, base_url, streaming, asincronia e gestione degli errori (2026)](/it/learn/anthropic-python-sdk/)[Acquistare crediti API Claude: guida alla ricarica e alla configurazione](/it/learn/buy-claude-api-credits/)[Il modo più economico per usare l'API Claude](/it/learn/cheapest-way-to-use-claude-api/)[Errore del server Claude? Tutti gli errori dell'API Claude spiegati — 400, limite di frequenza 429, 500, sovraccarico 529 e come risolverli](/it/learn/claude-api-errors-troubleshooting/)[Chiave API Claude gratuita? Cosa è davvero gratuito — API Claude gratuita, crediti di prova e l'opzione reale più economica (2026)](/it/learn/claude-api-free-trial/)[Guida all'integrazione dell'API Claude: SDK, REST e pattern per la produzione](/it/learn/claude-api-integration/)[I modelli Claude spiegati 2026 — Confronto dei modelli Claude: Claude Opus, Sonnet, Haiku e Fable, nomi e prezzi dei modelli Anthropic](/it/learn/claude-api-models-compared/)[I prezzi dell'API Claude spiegati](/it/learn/claude-api-pricing-explained/)[Gateway API Claude e accesso diretto ad Anthropic a confronto](/it/learn/claude-api-vs-anthropic-direct/)[API Claude e abbonamento Claude Pro/Max a confronto — Quale scegliere](/it/learn/claude-api-vs-subscription/)[Pagare l'API Claude con criptovalute](/it/learn/claude-api-with-crypto-payment/)[Accesso all'API Claude senza lista d'attesa](/it/learn/claude-api-without-waitlist/)[I prezzi di Claude Code spiegati: costi API, piani e come ridurli](/it/learn/claude-code-api-costs/)[Chiave API Claude Code (2026) — ANTHROPIC_API_KEY: come ottenerla, claude setup-token, token OAuth e chiave di sessione a confronto](/it/learn/claude-code-api-key-setup/)[API Claude Code: come funzionano chiavi, URL di base e fatturazione (2026)](/it/learn/claude-code-api/)[Come ottenere un utilizzo illimitato di Claude: piani e limiti](/it/learn/get-unlimited-claude-usage/)[Come ottenere una chiave API Claude: configurazione della console e del gateway](/it/learn/how-to-get-a-claude-api-key/)[Come ridurre l'utilizzo dei token di Claude](/it/learn/how-to-reduce-claude-token-usage/)[API Claude compatibile con OpenAI: usare Claude con l'SDK OpenAI (base_url, streaming, strumenti) (2026)](/it/learn/openai-compatible-claude-api/)[Hermes Agent con Claude sulla propria API: config.yaml del provider personalizzato e controlli dei costi (2026)](/it/learn/run-hermes-agent-with-claude-api/)[Eseguire OpenClaw senza limiti con Claude](/it/learn/run-openclaw-with-claude-api/)[API Claude illimitata: copertura e limiti di utilizzo corretto](/it/learn/unlimited-claude-api-access/)[Come ottenere una chiave API Claude illimitata](/it/learn/unlimited-claude-api-key/) [Tutti i 45 articoli della sezione Approfondimenti →](/it/learn/) Guide a Codex e all'API GPT: [Chiave API e accesso a Codex](/it/codex-api/) · [API compatibile con OpenAI](/it/openai-api/) · [Configurazione di Codex CLI](/it/docs/guides/codex-cli/) · [Confronto tra modelli GPT-6](/it/blog/gpt-6-models-for-codex/)