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.



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 versionamento 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. Usa 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 Google Cloud. 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



Paginazione

Gli endpoint di elenco restituiscono i risultati in pagine. La maggior parte degli endpoint di elenco più recenti utilizza lo schema di cursori page e next_page descritto in questa sezione. Alcuni utilizzano uno schema diverso; consulta la nota alla fine di questa sezione. Usa il parametro di query limit per controllare la dimensione della pagina e il parametro di query page per recuperare una pagina adiacente. Ogni risposta include un array data insieme ai campi cursore per navigare tra le pagine.

Per tornare indietro di una pagina, passa prev_page come parametro page. prev_page è null quando sei sulla prima pagina. Non tutti gli endpoint di elenco supportano prev_page. Solo GET /v1/sessions restituisce prev_page; sugli endpoint di elenco che non supportano la paginazione all'indietro, il campo è assente dalla risposta anziché null. Per una guida dettagliata alle richieste, consulta Elencare le sessioni.

Ogni SDK fornisce un iteratore con paginazione automatica che segue next_page per te. In Python e TypeScript, lo ottieni iterando direttamente il risultato dell'elenco. Gli altri SDK forniscono l'iteratore tramite un metodo separato. La paginazione automatica dell'SDK è solo in avanti; per tornare indietro di una pagina, leggi prev_page dalla risposta e passalo tu stesso come parametro page. Consulta client SDK per i dettagli specifici del linguaggio.



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; la tua organizzazione viene assegnata automaticamente a un livello e può passare a un livello superiore nel tempo. 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, usa Request rate limit increase nella pagina Limits.

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. Controlla la pagina delle regioni supportate per confermare la disponibilità nella tua località.



Passaggi successivi