Panoramica dell'API

La Claude API è una API RESTful disponibile all'indirizzo https://api.anthropic.com che fornisce accesso programmatico ai modelli Claude e ai Claude Managed Agents.



Prerequisiti

Per utilizzare la Claude API, avrai bisogno di:

• Un account Claude Console
• Una chiave API, oppure una regola di Workload Identity Federation configurata

Per istruzioni di configurazione passo passo, consulta Inizia subito.



API disponibili

La Claude API include le seguenti API:

Disponibilità generale:

• Messages API: Invia messaggi a Claude per interazioni conversazionali (POST /v1/messages)
• Message Batches API: Elabora grandi volumi di richieste Messages in modo asincrono con una riduzione dei costi del 50% (POST /v1/messages/batches)
• Token Counting API: Conta i token in un messaggio prima dell'invio per gestire costi e limiti di velocità (POST /v1/messages/count_tokens)
• Models API: Elenca i modelli Claude disponibili e i relativi dettagli (GET /v1/models)

Beta:

• Files API: Carica e gestisci file da utilizzare in più chiamate API (POST /v1/files, GET /v1/files)
• Skills API: Crea e gestisci skill personalizzate per gli agenti (POST /v1/skills, GET /v1/skills)
• Agents API: Definisci configurazioni di agenti riutilizzabili e versionate per i Claude Managed Agents (POST /v1/agents, GET /v1/agents)
• Sessions API: Esegui sessioni di agenti con stato in sandbox cloud gestite (POST /v1/sessions, GET /v1/sessions/{id}/stream)
• Environments API: Configura template di sandbox per le sessioni degli agenti (POST /v1/environments, GET /v1/environments)

Per il riferimento API completo con tutti gli endpoint, i parametri e gli schemi di risposta, esplora le pagine di riferimento API elencate nella navigazione. Per accedere alle funzionalità beta, consulta Header beta.



Autenticazione

Per i dettagli su entrambi i metodi di autenticazione e quando utilizzare ciascuno, consulta Autenticazione. Tutte le richieste alla Claude API devono includere questi header:

Se stai utilizzando i Client SDK, l'SDK invierà questi header automaticamente. Per i dettagli sul versioning dell'API, consulta Versioni dell'API.

Quando accedi a Claude tramite una piattaforma cloud, l'autenticazione è integrata con il sistema IAM del provider cloud. Consulta la documentazione specifica della piattaforma per i tipi di credenziali supportati, gli header richiesti e le opzioni di autenticazione.



Ottenere le chiavi API

L'API è resa disponibile tramite la Console web. Puoi utilizzare il Workbench per provare l'API nel browser e poi generare chiavi API nelle Impostazioni account. Utilizza i workspace per segmentare le tue chiavi API e controllare la spesa per caso d'uso.



Client SDK

Anthropic fornisce SDK ufficiali che semplificano l'integrazione con l'API gestendo autenticazione, formattazione delle richieste, gestione degli errori e altro ancora.

Vantaggi:

• Gestione automatica degli header (x-api-key, anthropic-version, content-type)
• Gestione type-safe di richieste e risposte
• Logica di retry e gestione degli errori integrate
• Supporto per lo streaming
• Timeout delle richieste e gestione delle connessioni

Per un elenco dei client SDK, consulta Client SDK.



Claude API vs piattaforme cloud

Claude è disponibile tramite la Claude API diretta e tramite piattaforme cloud. Scegli in base alla tua infrastruttura, alla disponibilità delle funzionalità, ai requisiti di conformità e alle preferenze di prezzo.



Claude API

• Accesso diretto ai modelli e alle funzionalità più recenti
• Fatturazione e supporto Anthropic
• Ideale per: Nuove integrazioni, accesso completo alle funzionalità, rapporto diretto con Anthropic



API delle piattaforme cloud

Accedi a Claude tramite AWS, Google Cloud o Microsoft Azure:

• Integrato con la fatturazione e l'IAM del provider cloud
• La disponibilità delle funzionalità varia in base alla piattaforma: le piattaforme gestite da Anthropic includono Claude Platform on AWS e Microsoft Foundry; le piattaforme gestite dai partner includono Amazon Bedrock e Vertex AI. Consulta la pagina di ciascuna piattaforma per la disponibilità e le tempistiche delle funzionalità.
• Ideale per: Impegni cloud esistenti, requisiti di conformità specifici, fatturazione cloud consolidata



Formato di richiesta e risposta



Limiti di dimensione delle richieste

Se superi questi limiti, riceverai un errore 413 request_too_large.



Header di risposta

La Claude API include i seguenti header in ogni risposta:

• request-id: Un identificatore univoco globale per la richiesta
• anthropic-organization-id: L'ID dell'organizzazione associato alla chiave API utilizzata nella richiesta



Limiti di velocità e disponibilità



Limiti di velocità

L'API applica "rate limits" (limiti di velocità) e limiti di spesa per prevenire abusi e gestire la capacità. I limiti sono organizzati in livelli di utilizzo che aumentano automaticamente man mano che utilizzi l'API. Ogni livello ha:

• Limiti di spesa: Costo mensile massimo per l'utilizzo dell'API
• Limiti di velocità: Numero massimo di richieste al minuto (RPM) e token al minuto (TPM)

Puoi visualizzare i limiti attuali della tua organizzazione nella Console. Per limiti più elevati o per il Priority Tier (livelli di servizio avanzati con spesa impegnata), contatta il team commerciale tramite la Console.

Per informazioni dettagliate su limiti, livelli e l'algoritmo token bucket utilizzato per il rate limiting, consulta Limiti di velocità.



Disponibilità

La Claude API è disponibile in molti paesi e regioni in tutto il mondo. Consulta la pagina delle regioni supportate per confermare la disponibilità nella tua località.



Passaggi successivi