Panoramica dell'API

La Claude API è un'API RESTful disponibile all'indirizzo 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 "API key" (chiave API), disponibile in chiavi 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:

• 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)
• 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 agenti (POST /v1/skills, GET /v1/skills)

Le seguenti API sono in beta:

• 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}/events/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 su 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 Playground per provare l'API nel browser e poi generare chiavi API in Impostazioni account. Scegli la scadenza di ciascuna chiave al momento della creazione. Usa i 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 allo 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 da 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 nelle sue risposte:

Per gli header dei limiti di velocità, consulta Header di risposta in Limiti di velocità. Per esempi che leggono un header di risposta per nome con ciascun SDK, consulta Identificare il workspace dietro una risposta API.



Paginazione

Gli endpoint di elenco restituiscono i risultati in pagine. La maggior parte degli endpoint di elenco più recenti usa lo schema a cursore 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 ti trovi 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 passo passo 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 degli SDK è solo in avanti; per tornare indietro di una pagina, leggi prev_page dalla risposta e passalo tu stesso come parametro page. Consulta SDK client per i dettagli specifici di ciascun 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 tuoi limiti di velocità nella pagina Limiti di velocità e i tuoi limiti di spesa nella pagina Fatturazione nella Console. Per limiti di velocità più elevati o un tetto di spesa mensile più alto, usa Request rate limit increase nella pagina Limiti di velocità.

Per informazioni dettagliate su limiti, livelli e sull'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 località.



Prossimi passi