---
title: Panoramica dell'API
url: https://platform.claude.com/docs/it/api/overview
description: Comprendi gli endpoint disponibili dell'API di Claude, gli header di autenticazione, gli SDK client, la paginazione, i limiti di velocità e le opzioni di accesso alle piattaforme cloud.
---
L'API di Claude è un'API RESTful disponibile all'indirizzo `https://api.anthropic.com` che fornisce accesso programmatico ai modelli Claude e ai Claude Managed Agents.
**Nuovo su Claude?** Per l'accesso diretto ai modelli, inizia con [Inizia](https://platform.claude.com/docs/it/get-started) e [Lavorare con i Messaggi](https://platform.claude.com/docs/it/build-with-claude/working-with-messages). Per l'infrastruttura di agenti gestiti, consulta la [guida rapida ai Claude Managed Agents](https://platform.claude.com/docs/it/managed-agents/quickstart).
## Prerequisiti
Per utilizzare l'API di Claude, avrai bisogno di:
* Un [account Claude Console](https://platform.claude.com)
* Una [chiave API](https://platform.claude.com/settings/keys) dalla Console, oppure una regola di [Workload Identity Federation](https://platform.claude.com/docs/it/manage-claude/workload-identity-federation) configurata
Per istruzioni di configurazione passo passo, consulta [Inizia](https://platform.claude.com/docs/it/get-started).
## API disponibili
L'API di Claude include le seguenti API:
* **[Messages API](https://platform.claude.com/docs/it/api/messages/create)**: Invia messaggi a Claude per interazioni conversazionali (`POST /v1/messages`)
* **[Message Batches API](https://platform.claude.com/docs/it/api/messages/batches/create)**: Elabora grandi volumi di richieste Messages in modo asincrono con una riduzione dei costi del 50% (`POST /v1/messages/batches`)
* **[Token Counting API](https://platform.claude.com/docs/it/api/messages/count_tokens)**: Conta i token in un messaggio prima dell'invio per gestire costi e limiti di velocità (`POST /v1/messages/count_tokens`)
* **[Models API](https://platform.claude.com/docs/it/api/models/list)**: Elenca i modelli Claude disponibili e i loro dettagli (`GET /v1/models`)
* **[Files API](https://platform.claude.com/docs/it/api/files/upload)**: Carica e gestisci file da utilizzare in più chiamate API (`POST /v1/files`, `GET /v1/files`)
* **[Skills API](https://platform.claude.com/docs/it/api/skills/create)**: Crea e gestisci skill personalizzate per agenti (`POST /v1/skills`, `GET /v1/skills`)
Le seguenti API sono in beta:
* **[Agents API](https://platform.claude.com/docs/it/managed-agents/agent-setup)**: Definisci configurazioni di agenti riutilizzabili e versionate per i Claude Managed Agents (`POST /v1/agents`, `GET /v1/agents`)
* **[Sessions API](https://platform.claude.com/docs/it/managed-agents/sessions)**: Esegui sessioni di agenti con stato in sandbox cloud gestite (`POST /v1/sessions`, `GET /v1/sessions/{id}/events/stream`)
* **[Environments API](https://platform.claude.com/docs/it/managed-agents/environments)**: Configura template di sandbox per le sessioni di 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 [Beta headers](https://platform.claude.com/docs/it/api/beta-headers).
## Autenticazione
Per i dettagli su ciascun metodo di autenticazione e su quando utilizzarlo, consulta [Autenticazione](https://platform.claude.com/docs/it/manage-claude/authentication). Le richieste all'API di Claude includono questi header:
| Header | Valore | Obbligatorio |
| ------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `Authorization` | `Bearer `, dove `` è la tua chiave API o un token di accesso di breve durata ottenuto da `POST /v1/oauth/token` tramite [Workload Identity Federation](https://platform.claude.com/docs/it/manage-claude/workload-identity-federation) | Sì, a meno che non sia impostato `x-api-key` |
| `x-api-key` | La tua chiave API dalla Console. Alternativa legacy ad `Authorization`, ancora supportata | No |
| `anthropic-workspace-id` | ID del [workspace](https://platform.claude.com/docs/it/manage-claude/workspaces) in cui viene eseguita la richiesta (ad esempio, `wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ`). Consulta [Selezionare un workspace](https://platform.claude.com/docs/it/manage-claude/authentication#select-a-workspace). | Obbligatorio con una chiave API multi-workspace. Facoltativo per le altre chiavi API. Una chiave creata per un singolo workspace viene eseguita in quel workspace quando ometti l'header. Non usato con i token di Workload Identity Federation, che selezionano un workspace al momento dello scambio del token. |
| `anthropic-version` | Versione dell'API (ad esempio, `2023-06-01`) | Sì |
| `content-type` | `application/json` | Sì |
Se stai utilizzando gli [SDK client](https://platform.claude.com/docs/it/api/overview#client-sdks), l'SDK invia automaticamente gli header di autenticazione, versione e content-type; passi tu stesso `anthropic-workspace-id` quando la tua chiave lo richiede. Per i dettagli sul versioning dell'API, consulta [Versioni dell'API](https://platform.claude.com/docs/it/api/versioning).
Quando accedi a Claude tramite una [piattaforma cloud](https://platform.claude.com/docs/it/api/overview#claude-api-vs-cloud-platforms), 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](https://platform.claude.com/) web. Nella Console, puoi usare il [playground](https://platform.claude.com/playground) (`platform.claude.com/playground`) per provare l'API nel browser e poi generare chiavi API nella pagina [Chiavi API](https://platform.claude.com/settings/keys) (`platform.claude.com/settings/keys`). Per sapere come fare, consulta [Ottieni la tua chiave API di Claude](https://platform.claude.com/docs/it/get-api-key). Scegli il tipo di ciascuna chiave (consulta [Tipi di chiave](https://platform.claude.com/docs/it/manage-claude/authentication#key-types)) e la sua [scadenza](https://platform.claude.com/docs/it/manage-claude/authentication#key-expiration) al momento della creazione. Usa i [workspace](https://platform.claude.com/settings/workspaces) nella Console per separare gli ambienti e [controllare la spesa](https://platform.claude.com/docs/it/api/rate-limits) per caso d'uso.
## SDK client
Anthropic fornisce SDK ufficiali che semplificano l'integrazione dell'API gestendo l'autenticazione, la formattazione delle richieste, la gestione degli errori e altro ancora.
**Vantaggi:**
* Gestione automatica degli header (autenticazione, `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](https://platform.claude.com/docs/it/cli-sdks-libraries/overview).
## API di Claude vs piattaforme cloud
Claude è disponibile tramite l'API diretta di Claude e tramite piattaforme cloud. Scegli in base alla tua infrastruttura, alla disponibilità delle funzionalità, ai requisiti di conformità e alle preferenze di prezzo.
### API di Claude
* **Accesso diretto** ai modelli e alle funzionalità più recenti
* **Fatturazione e supporto Anthropic**
* **Ideale per:** Nuove integrazioni, accesso completo alle funzionalità, relazione diretta 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](https://platform.claude.com/docs/it/build-with-claude/claude-platform-on-aws) e [Microsoft Foundry](https://platform.claude.com/docs/it/build-with-claude/claude-in-microsoft-foundry); le piattaforme gestite da partner includono Amazon Bedrock e Google Cloud. Consulta la pagina di ciascuna piattaforma per la disponibilità e i tempi delle funzionalità.
* **Ideale per:** Impegni cloud esistenti, requisiti di conformità specifici, fatturazione cloud consolidata
| Piattaforma | Provider | Documentazione |
| ---------------------- | -------------------------------------- | ---------------------------------------------------------------------------------------------------------------- |
| Agent Platform | Google Cloud | [Claude su Google Cloud](https://platform.claude.com/docs/it/build-with-claude/claude-on-vertex-ai) |
| Amazon Bedrock | AWS | [Claude in Amazon Bedrock](https://platform.claude.com/docs/it/build-with-claude/claude-in-amazon-bedrock) |
| Claude Platform on AWS | AWS (gestito da Anthropic) | [Claude Platform on AWS](https://platform.claude.com/docs/it/build-with-claude/claude-platform-on-aws) |
| Microsoft Foundry | Microsoft Azure (gestito da Anthropic) | [Claude in Microsoft Foundry](https://platform.claude.com/docs/it/build-with-claude/claude-in-microsoft-foundry) |
Claude Managed Agents è disponibile tramite l'API diretta di Claude e [Claude Platform on AWS](https://platform.claude.com/docs/it/build-with-claude/claude-platform-on-aws). Per la disponibilità delle funzionalità tra le piattaforme, consulta la [Panoramica delle funzionalità](https://platform.claude.com/docs/it/build-with-claude/overview).
## Formato di richiesta e risposta
### Limiti di dimensione delle richieste
| Endpoint | Dimensione massima della richiesta |
| --------------------------------------------------------------------------------------------- | ---------------------------------- |
| Messages, Token Counting | 32 MB |
| [Message Batches API](https://platform.claude.com/docs/it/build-with-claude/batch-processing) | 256 MB |
| [Files API](https://platform.claude.com/docs/it/build-with-claude/files) | 500 MB |
| Sessions, Agents, Environments | 32 MB |
Se superi questi limiti, riceverai un errore 413 `request_too_large`.
Le piattaforme gestite da partner hanno i propri limiti di dimensione delle richieste: Bedrock limita le richieste a 20 MB e Google Cloud limita le richieste a 30 MB. Claude Platform on AWS utilizza gli stessi limiti dell'API diretta di Claude. Consulta la documentazione della tua piattaforma per i valori attuali.
### Header di risposta
L'API di Claude include i seguenti header nelle sue risposte:
| Header | Descrizione |
| --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `request-id` | Un identificatore univoco globale per la richiesta, come `req_018EeWyXxfu5pfWkrYcMdjWG`. Includilo quando contatti il supporto riguardo a una richiesta specifica. Consulta [Request ID](https://platform.claude.com/docs/it/api/errors#request-id). |
| `anthropic-organization-id` | L'ID dell'organizzazione a cui appartiene la chiave API o il token di accesso utilizzato nella richiesta. |
| `anthropic-workspace-id` | L'ID con prefisso `wrkspc_` del [workspace](https://platform.claude.com/docs/it/manage-claude/workspaces) a cui la chiave API o il token di accesso è stato risolto, come `wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ`, incluso quando si tratta del Workspace predefinito della tua organizzazione. Assente quando la credenziale non si risolve in un workspace (ad esempio, nelle richieste Admin API) o la richiesta fallisce prima del completamento dell'autenticazione. Consulta [Identifica il workspace dietro una risposta API](https://platform.claude.com/docs/it/manage-claude/workspaces#identify-the-workspace-behind-an-api-response). |
Per gli header dei limiti di velocità, consulta [Header di risposta](https://platform.claude.com/docs/it/api/rate-limits#response-headers) in Limiti di velocità. Per esempi che leggono un header di risposta per nome con ciascun SDK, consulta [Identifica il workspace dietro una risposta API](https://platform.claude.com/docs/it/manage-claude/workspaces#identify-the-workspace-behind-an-api-response).
Claude Platform on AWS aggiunge un ID di richiesta AWS (`x-amzn-requestid`) accanto all'header standard `request-id`. Consulta [Request IDs](https://platform.claude.com/docs/it/build-with-claude/claude-platform-on-aws#request-ids) per il pattern di gestione del doppio ID.
## Paginazione
Gli endpoint di elenco restituiscono i risultati in pagine. La maggior parte degli endpoint di elenco più recenti utilizza lo schema di cursore `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 del cursore per navigare tra le pagine.
| Nome | Posizione | Descrizione |
| ----------- | ------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `limit` | Parametro di query | Numero massimo di elementi da restituire per pagina. |
| `page` | Parametro di query | Cursore opaco da una risposta precedente. Passa qui un valore `next_page` o `prev_page` per recuperare la pagina adiacente. |
| `order` | Parametro di query | Direzione di ordinamento per i risultati (`asc` o `desc`), sugli endpoint di elenco che supportano l'ordinamento. Un cursore `page` è valido solo con l'`order` con cui è stato creato. |
| `next_page` | Campo di risposta | Cursore per la pagina successiva, o `null` se non ci sono altri risultati. |
| `prev_page` | Campo di risposta | Cursore per la pagina precedente sugli endpoint che supportano la paginazione all'indietro (attualmente `GET /v1/sessions`), o `null` se sei sulla prima pagina. Gli altri endpoint di elenco omettono il campo. |
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](https://platform.claude.com/docs/it/managed-agents/session-operations#listing-sessions).
L'SDK fornisce un iteratore con paginazione automatica che segue `next_page` per te. Ad esempio, `for session in client.beta.sessions.list()` (typescript: `for await (const session of client.beta.sessions.list())`; go: `client.Beta.Sessions.ListAutoPaging()`; java: `client.beta().sessions().list().autoPager()`; csharp: `(await client.Beta.Sessions.List()).Paginate()`; php: `$client->beta->sessions->list()->pagingEachItem()`; ruby: `client.beta.sessions.list.auto_paging_each`) scorre tutte le sessioni. La paginazione automatica dell'SDK procede solo in avanti; per tornare indietro di una pagina, leggi `prev_page` dalla risposta e ripassalo tu stesso come parametro `page`. Consulta gli [SDK client](https://platform.claude.com/docs/it/cli-sdks-libraries/overview) per i dettagli.
Alcuni endpoint di elenco utilizzano uno schema di cursore diverso. La [Message Batches API](https://platform.claude.com/docs/it/build-with-claude/batch-processing), la [Models API](https://platform.claude.com/docs/it/api/models/list) e diversi endpoint [Admin API](https://platform.claude.com/docs/it/manage-claude/admin-api) accettano i parametri di query `after_id` e `before_id` anziché `page`. Le loro risposte restituiscono `has_more`, `first_id` e `last_id` anziché `next_page`. Consulta la pagina di riferimento di ciascun endpoint per i suoi campi di paginazione esatti.
## 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 tuoi limiti di velocità nella pagina [Limiti di velocità](https://platform.claude.com/usage/limits) e i tuoi limiti di spesa nella pagina [Fatturazione](https://platform.claude.com/settings/billing) della Console. Per limiti di velocità più elevati o un tetto di spesa mensile più alto, usa **Richiedi aumento di livello** nella pagina Limiti di velocità.
Per informazioni dettagliate su limiti, livelli e l'algoritmo token bucket utilizzato per la limitazione della velocità, consulta [Limiti di velocità](https://platform.claude.com/docs/it/api/rate-limits).
### Disponibilità
L'API di Claude è disponibile in [molti paesi e regioni](https://platform.claude.com/docs/it/api/supported-regions) in tutto il mondo. Controlla la pagina delle regioni supportate per confermare la disponibilità nella tua posizione.
## Prossimi passi
Specifica API completa per le interazioni dirette con i modelli
Endpoint Agents, Sessions ed Environments
Python, TypeScript, C#, Go, Java, PHP e Ruby
Livelli di utilizzo, richiesta di limiti più elevati e l'algoritmo token bucket