Panoramica dell'API

La Claude API è un'API RESTful disponibile su https://api.anthropic.com che fornisce accesso programmatico ai modelli Claude e a Claude Managed Agents.



Prerequisiti

Per usare 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 dopo 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 loro dettagli (GET /v1/models)

Beta:

• Files API: Carica e gestisci file da usare 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 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 modelli 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 usare ciascuno, consulta Autenticazione. Tutte le richieste alla Claude API devono includere questi header:

Se stai usando gli SDK client, 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 usare il Workbench per provare l'API nel browser e poi generare chiavi API in Impostazioni account. Scegli la scadenza di ogni chiave al momento della creazione. Usa gli workspace per segmentare le tue chiavi API e controllare la spesa per caso d'uso.



SDK client

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 degli SDK client, consulta SDK client.



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à delle funzionalità e le tempistiche.
• 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 usata nella richiesta



Paginazione

Gli endpoint di elenco restituiscono i risultati in pagine. La maggior parte degli endpoint di elenco più recenti usa lo schema di cursori page e next_page descritto in questa sezione. Alcuni usano 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é essere null. Per una guida passo passo alla richiesta, 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 degli SDK è solo in avanti; per tornare indietro di una pagina, leggi prev_page dalla risposta e passalo tu stesso come parametro page. Consulta gli SDK client per i dettagli specifici di ciascun linguaggio.



Limiti di velocità e disponibilità



Limiti di velocità

L'API applica 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 usato per la limitazione della velocità, 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 area.



Prossimi passi