--- title: API di utilizzo e costi url: https://platform.claude.com/docs/it/manage-claude/usage-cost-api description: Accedi in modo programmatico ai dati di utilizzo e costo dell'API della tua organizzazione con la Usage and Cost Admin API. --- **L'Admin API non è disponibile per gli account individuali.** Per collaborare con i colleghi e aggiungere membri, configura la tua organizzazione nella pagina [Organization](https://platform.claude.com/settings/organization) (`platform.claude.com/settings/organization`) nella Claude Console. La Usage and Cost Admin API fornisce un accesso programmatico e granulare ai dati storici di utilizzo e costo dell'API per la tua organizzazione. Questi dati sono simili alle informazioni disponibili nella pagina [Usage](https://platform.claude.com/usage) (`platform.claude.com/usage`) e nella pagina [Cost](https://platform.claude.com/cost) (`platform.claude.com/cost`) della Claude Console. Questa API ti consente di monitorare, analizzare e ottimizzare meglio le tue implementazioni di Claude: * **Tracciamento accurato dell'utilizzo:** Ottieni conteggi precisi dei token e pattern di utilizzo invece di affidarti esclusivamente al conteggio dei token di risposta * **Riconciliazione dei costi:** Abbina i record interni con la fatturazione di Anthropic per i team finanziari e contabili * **Prestazioni e miglioramento del prodotto:** Monitora le prestazioni del prodotto misurando se le modifiche al sistema lo hanno migliorato, oppure imposta avvisi * **Ottimizzazione dei [limiti di velocità](https://platform.claude.com/docs/it/api/rate-limits):** Ottimizza funzionalità come la [cache dei prompt](https://platform.claude.com/docs/it/build-with-claude/prompt-caching) o prompt specifici per sfruttare al meglio la capacità allocata. * **Analisi avanzata:** Esegui analisi dei dati più approfondite rispetto a quanto disponibile nella Console **Credenziali Admin API richieste.** Questi endpoint fanno parte dell'Admin API. Puoi accedervi utilizzando una [chiave Admin API](https://platform.claude.com/docs/it/manage-claude/admin-api-keys), un token OAuth con lo scope `org:admin`, oppure una chiave personale o di account di servizio che non sia limitata a un workspace; le chiavi API di workspace non funzionano. Consulta [Autenticazione](https://platform.claude.com/docs/it/manage-claude/admin-api#authentication) per i dettagli. Le organizzazioni Claude Enterprise utilizzano invece una chiave API Analytics con un'API diversa; consulta [Quale API ti serve?](https://platform.claude.com/docs/it/manage-claude/usage-cost-api#which-api-do-you-need). **Claude Platform su AWS:** Gli endpoint programmatici della Usage and Cost API non sono attualmente disponibili. Visualizza invece i dati di utilizzo e costo nelle pagine **Usage** e **Cost** della Claude Console. ## Quale API ti serve? Anthropic fornisce report di costo e utilizzo tramite due API, a seconda di quale prodotto Claude gestisce la tua organizzazione: | La tua organizzazione | API | Tipo di chiave | | -------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ | | Claude Console (Claude Platform) | La Usage and Cost Admin API descritta in questa pagina | Chiave Admin API (`sk-ant-admin01-...`) o un'altra [credenziale Admin API](https://platform.claude.com/docs/it/manage-claude/admin-api#authentication) | | Claude Enterprise (claude.ai) | Gli endpoint di costo e utilizzo della [Claude Enterprise Analytics API](https://platform.claude.com/docs/it/api/beta/organization/analytics) | Chiave API Analytics | Le organizzazioni principali Claude Enterprise non appaiono nella Claude Console e non dispongono di chiavi Admin API, quindi per esse la chiave API Analytics è l'unico modo per accedere a questi dati. Consulta [Analytics APIs](https://platform.claude.com/docs/it/manage-claude/analytics-api) per sapere come creare ciascun tipo di chiave e a quali piani si applicano i dati di costo di Claude Enterprise. ## Soluzioni partner Le principali piattaforme di osservabilità offrono integrazioni pronte all'uso per monitorare l'utilizzo e il costo della tua API Claude, senza scrivere codice personalizzato. Queste integrazioni forniscono dashboard, avvisi e analisi per aiutarti a gestire efficacemente l'utilizzo della tua API. Piattaforma di cloud intelligence per il monitoraggio e la previsione dei costi Osservabilità degli LLM con tracciamento e monitoraggio automatici Integrazione senza agenti per una facile osservabilità degli LLM con dashboard e avvisi pronti all'uso Piattaforma FinOps per la gestione dei costi cloud e IA Query e visualizzazioni avanzate tramite OpenTelemetry Attribuzione di utilizzo e costi agli elementi di lavoro Jira Piattaforma FinOps per l'osservabilità di costi e utilizzo degli LLM ## Avvio rapido Ottieni l'utilizzo giornaliero della tua organizzazione per gli ultimi 7 giorni: ```bash cURL curl "https://api.anthropic.com/v1/organizations/usage_report/messages?\ starting_at=2025-01-08T00:00:00Z&\ ending_at=2025-01-15T00:00:00Z&\ bucket_width=1d" \ -H "anthropic-version: 2023-06-01" \ -H "x-api-key: $ANTHROPIC_ADMIN_KEY" ``` **Imposta un header User-Agent per le integrazioni** Se stai creando un'integrazione, imposta il tuo header User-Agent per aiutare Anthropic a comprendere i pattern di utilizzo: ```text wrap User-Agent: YourApp/1.0.0 (https://yourapp.com) ``` ## Usage API Traccia il consumo di token nella tua organizzazione con suddivisioni dettagliate per modello, workspace e service tier con l'endpoint `/v1/organizations/usage_report/messages`. ### Concetti chiave * **Time bucket:** Aggrega i dati di utilizzo in intervalli fissi (`1m`, `1h` o `1d`) * **Tracciamento dei token:** Misura i token di input non memorizzati in cache, di input memorizzati in cache, di creazione della cache e di output * **Filtraggio e raggruppamento:** Filtra per chiave API, workspace, modello, service tier, finestra di contesto, [data residency](https://platform.claude.com/docs/it/manage-claude/data-residency) o velocità, e raggruppa i risultati per queste dimensioni * **Utilizzo degli strumenti server:** Traccia l'uso degli strumenti lato server come la ricerca web Per i dettagli completi dei parametri e gli schemi di risposta, consulta il [riferimento della Usage API](https://platform.claude.com/docs/it/api/beta/organization/usage_report/retrieve_messages). ### Esempi di base #### Utilizzo giornaliero per modello ```bash cURL curl "https://api.anthropic.com/v1/organizations/usage_report/messages?\ starting_at=2025-01-01T00:00:00Z&\ ending_at=2025-01-08T00:00:00Z&\ group_by[]=model&\ bucket_width=1d" \ -H "anthropic-version: 2023-06-01" \ -H "x-api-key: $ANTHROPIC_ADMIN_KEY" ``` #### Utilizzo orario con filtraggio ```bash cURL curl "https://api.anthropic.com/v1/organizations/usage_report/messages?\ starting_at=2025-01-15T00:00:00Z&\ ending_at=2025-01-15T23:59:59Z&\ models[]=claude-opus-5-5&\ service_tiers[]=batch&\ context_window[]=0-200k&\ bucket_width=1h" \ -H "anthropic-version: 2023-06-01" \ -H "x-api-key: $ANTHROPIC_ADMIN_KEY" ``` #### Filtra l'utilizzo per chiave API e workspace ```bash cURL curl "https://api.anthropic.com/v1/organizations/usage_report/messages?\ starting_at=2025-01-01T00:00:00Z&\ ending_at=2025-01-08T00:00:00Z&\ api_key_ids[]=apikey_01Rj2N8SVvo6BePZj99NhmiT&\ api_key_ids[]=apikey_01ABC123DEF456GHI789JKL&\ workspace_ids[]=wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ&\ workspace_ids[]=wrkspc_01XYZ789ABC123DEF456MNO&\ bucket_width=1d" \ -H "anthropic-version: 2023-06-01" \ -H "x-api-key: $ANTHROPIC_ADMIN_KEY" ``` Per recuperare gli ID delle chiavi API della tua organizzazione, usa l'endpoint [List API Keys](https://platform.claude.com/docs/it/api/organization/api_keys/list). Per recuperare gli ID dei workspace della tua organizzazione, usa l'endpoint [List Workspaces](https://platform.claude.com/docs/it/api/organization/workspaces/list), oppure trova gli ID dei workspace della tua organizzazione nella Claude Console. #### Residenza dei dati Traccia i tuoi [controlli di data residency](https://platform.claude.com/docs/it/manage-claude/data-residency) raggruppando e filtrando l'utilizzo con la dimensione `inference_geo`. Questo è utile per verificare il routing geografico nella tua organizzazione. ```bash cURL curl "https://api.anthropic.com/v1/organizations/usage_report/messages?\ starting_at=2026-02-01T00:00:00Z&\ ending_at=2026-02-08T00:00:00Z&\ group_by[]=inference_geo&\ group_by[]=model&\ bucket_width=1d" \ -H "anthropic-version: 2023-06-01" \ -H "x-api-key: $ANTHROPIC_ADMIN_KEY" ``` Puoi anche filtrare per una geo specifica. I valori validi sono `global`, `us` e `not_available`: ```bash cURL curl "https://api.anthropic.com/v1/organizations/usage_report/messages?\ starting_at=2026-02-01T00:00:00Z&\ ending_at=2026-02-08T00:00:00Z&\ inference_geos[]=us&\ group_by[]=model&\ bucket_width=1d" \ -H "anthropic-version: 2023-06-01" \ -H "x-api-key: $ANTHROPIC_ADMIN_KEY" ``` I modelli rilasciati prima di febbraio 2026 (precedenti a Claude Opus 4.6 e Claude Sonnet 4.6) non supportano il parametro di richiesta `inference_geo`, quindi i loro report di utilizzo restituiscono `"not_available"` per questa dimensione. Puoi usare `not_available` come valore di filtro in `inference_geos[]` per indirizzare quei modelli. #### Modalità veloce Traccia l'utilizzo della [fast mode](https://platform.claude.com/docs/it/build-with-claude/fast-mode) raggruppando e filtrando con la dimensione `speed`. Questo è utile per monitorare l'utilizzo della modalità standard rispetto a quella fast. ```bash cURL curl "https://api.anthropic.com/v1/organizations/usage_report/messages?\ starting_at=2026-02-01T00:00:00Z&\ ending_at=2026-02-08T00:00:00Z&\ group_by[]=speed&\ group_by[]=model&\ bucket_width=1d" \ -H "anthropic-version: 2023-06-01" \ -H "x-api-key: $ANTHROPIC_ADMIN_KEY" ``` Puoi anche filtrare per una velocità specifica. I valori validi sono `standard` e `fast`: ```bash cURL curl "https://api.anthropic.com/v1/organizations/usage_report/messages?\ starting_at=2026-02-01T00:00:00Z&\ ending_at=2026-02-08T00:00:00Z&\ speeds[]=fast&\ group_by[]=model&\ bucket_width=1d" \ -H "anthropic-version: 2023-06-01" \ -H "x-api-key: $ANTHROPIC_ADMIN_KEY" ``` ### Limiti di granularità temporale | Granularità | Limite predefinito | Limite massimo | Caso d'uso | | ----------- | ------------------ | -------------- | --------------------------- | | `1m` | 60 bucket | 1.440 bucket | Monitoraggio in tempo reale | | `1h` | 24 bucket | 168 bucket | Pattern giornalieri | | `1d` | 7 bucket | 31 bucket | Report settimanali/mensili | ## Cost API Recupera suddivisioni dei costi a livello di servizio in USD con l'endpoint `/v1/organizations/cost_report`. ### Concetti chiave * **Valuta:** Tutti i costi in USD, riportati come stringhe decimali nelle unità più basse (centesimi) * **Tipi di costo:** Traccia i costi di utilizzo dei token, ricerca web ed esecuzione di codice * **Raggruppamento:** Raggruppa i costi per workspace o descrizione per suddivisioni dettagliate. Quando si raggruppa per `description`, le risposte includono campi analizzati come `model` e `inference_geo` * **Time bucket:** Solo granularità giornaliera (`1d`) Per i dettagli completi dei parametri e gli schemi di risposta, consulta il [riferimento della Cost API](https://platform.claude.com/docs/it/api/beta/organization/cost_report/retrieve). I costi del Priority Tier utilizzano un modello di fatturazione diverso e non sono inclusi nell'endpoint dei costi. Traccia invece l'utilizzo del Priority Tier tramite l'endpoint di utilizzo. ### Esempio di base ```bash cURL curl "https://api.anthropic.com/v1/organizations/cost_report?\ starting_at=2025-01-01T00:00:00Z&\ ending_at=2025-01-31T00:00:00Z&\ group_by[]=workspace_id&\ group_by[]=description" \ -H "anthropic-version: 2023-06-01" \ -H "x-api-key: $ANTHROPIC_ADMIN_KEY" ``` ## Paginazione Entrambi gli endpoint supportano la paginazione per dataset di grandi dimensioni: 1. Effettua la tua richiesta iniziale. 2. Se `has_more` è `true`, usa il valore `next_page` nella tua richiesta successiva. 3. Continua finché `has_more` non è `false`. ```bash cURL # Prima richiesta curl "https://api.anthropic.com/v1/organizations/usage_report/messages?\ starting_at=2025-01-01T00:00:00Z&\ ending_at=2025-01-31T00:00:00Z&\ limit=7" \ -H "anthropic-version: 2023-06-01" \ -H "x-api-key: $ANTHROPIC_ADMIN_KEY" # La risposta include: "has_more": true, "next_page": "page_xyz..." # Richiesta successiva con paginazione curl "https://api.anthropic.com/v1/organizations/usage_report/messages?\ starting_at=2025-01-01T00:00:00Z&\ ending_at=2025-01-31T00:00:00Z&\ limit=7&\ page=page_xyz..." \ -H "anthropic-version: 2023-06-01" \ -H "x-api-key: $ANTHROPIC_ADMIN_KEY" ``` ## Casi d'uso comuni Esplora implementazioni dettagliate nel [Claude Cookbook](https://platform.claude.com/cookbook): * **Report di utilizzo giornaliero:** Traccia le tendenze del consumo di token * **Attribuzione dei costi:** Alloca le spese per workspace per i chargeback * **Efficienza della cache:** Misura e ottimizza la cache dei prompt * **Monitoraggio del budget:** Imposta avvisi per le soglie di spesa * **Esportazione CSV:** Genera report per i team finanziari ## Domande frequenti ### Quanto sono aggiornati i dati? I dati di utilizzo e costo appaiono tipicamente entro 5 minuti dal completamento della richiesta API, anche se i ritardi possono occasionalmente essere più lunghi. ### Qual è la frequenza di polling consigliata? L'API supporta il polling una volta al minuto per un uso prolungato. Per brevi raffiche (ad esempio, il download di dati paginati), è accettabile un polling più frequente. Memorizza nella cache i risultati per le dashboard che necessitano di aggiornamenti frequenti. ### Come traccio l'utilizzo dell'esecuzione di codice? I costi di esecuzione di codice appaiono nell'endpoint dei costi raggruppati sotto `Code Execution Usage` nel campo descrizione. L'esecuzione di codice non è inclusa nell'endpoint di utilizzo. ### Come traccio l'utilizzo del Priority Tier? Filtra o raggruppa per `service_tier` nell'endpoint di utilizzo e cerca il valore `priority`. I costi del Priority Tier non sono disponibili nell'endpoint dei costi. ### Cosa succede con l'utilizzo del playground? L'utilizzo dell'API dal playground nella Claude Console (e dal precedente Workbench prima di esso) non è associato a una chiave API, quindi `api_key_id` sarà `null` anche quando si raggruppa per quella dimensione. ### Come è rappresentato il workspace predefinito? L'utilizzo e i costi attribuiti al workspace predefinito hanno un valore `null` per `workspace_id`. ### Come ottengo suddivisioni dei costi per utente per Claude Code? Usa la [Claude Code Analytics API](https://platform.claude.com/docs/it/manage-claude/claude-code-analytics-api), che fornisce costi stimati per utente e metriche di produttività senza le limitazioni di prestazioni derivanti dalla suddivisione dei costi per molte chiavi API. Per l'utilizzo generale dell'API con molte chiavi, usa la [Usage API](https://platform.claude.com/docs/it/manage-claude/usage-cost-api#usage-api) per tracciare il consumo di token come proxy dei costi. ## Vedi anche Usa le Usage and Cost API per offrire un'esperienza migliore ai tuoi utenti, gestire i costi e preservare il tuo limite di velocità. Scopri di più su alcune di queste altre funzionalità: * [Admin API](https://platform.claude.com/docs/it/manage-claude/admin-api) * [Riferimento Admin API](https://platform.claude.com/docs/it/api/beta/organization) * [Analytics APIs](https://platform.claude.com/docs/it/manage-claude/analytics-api) - Quale API analytics e tipo di chiave serve alla tua organizzazione * [Prezzi](https://platform.claude.com/docs/it/about-claude/pricing) * [Cache dei prompt](https://platform.claude.com/docs/it/build-with-claude/prompt-caching) - Ottimizza i costi con la cache * [Elaborazione batch](https://platform.claude.com/docs/it/build-with-claude/batch-processing) - Sconto del 50% sulle richieste batch * [Limiti di velocità](https://platform.claude.com/docs/it/api/rate-limits) - Comprendi i tier di utilizzo * [Rate Limits API](https://platform.claude.com/docs/it/manage-claude/rate-limits-api) - Leggi i tuoi limiti di velocità configurati * [Data residency](https://platform.claude.com/docs/it/manage-claude/data-residency) - Controlla la geografia dell'inferenza