API di Utilizzo e Costi

The Admin API is unavailable for individual accounts. To collaborate with teammates and add members, set up your organization in Console → Settings → Organization.

L'API Admin di Utilizzo e Costi fornisce accesso programmatico e granulare ai dati storici di utilizzo e costi API per la tua organizzazione. Questi dati sono simili alle informazioni disponibili nelle pagine Utilizzo e Costi della Console Claude.

Questa API ti consente di monitorare, analizzare e ottimizzare meglio le tue implementazioni Claude:

Tracciamento Accurato dell'Utilizzo: Ottieni conteggi precisi dei token e modelli di utilizzo invece di affidarti esclusivamente al conteggio dei token di risposta
Riconciliazione dei Costi: Abbina i record interni con la fatturazione Anthropic per i team di finanza e contabilità
Prestazioni e miglioramento del prodotto: Monitora le prestazioni del prodotto misurando se le modifiche al sistema l'hanno migliorato, o configura avvisi
Ottimizzazione dei limiti di velocità e Livello Priorità: Ottimizza funzionalità come il caching dei prompt o prompt specifici per sfruttare al meglio la capacità allocata, o acquista capacità dedicata.
Analisi Avanzata: Esegui analisi dei dati più approfondite di quelle disponibili nella Console

Chiave API Admin richiesta

Questa API fa parte dell'API Admin. Questi endpoint richiedono una chiave API Admin (che inizia con sk-ant-admin...) che differisce dalle chiavi API standard. Solo i membri dell'organizzazione con ruolo admin possono fornire chiavi API Admin attraverso la Console Claude.

Soluzioni partner

Le principali piattaforme di osservabilità offrono integrazioni pronte all'uso per monitorare l'utilizzo e i costi 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.

Datadog

Osservabilità LLM con tracciamento e monitoraggio automatici

Avvio rapido

Ottieni l'utilizzo giornaliero della tua organizzazione per gli ultimi 7 giorni:

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" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ADMIN_API_KEY"

Imposta un header User-Agent per le integrazioni

Se stai costruendo un'integrazione, imposta il tuo header User-Agent per aiutarci a comprendere i modelli di utilizzo:

User-Agent: YourApp/1.0.0 (https://yourapp.com)

API di Utilizzo

Traccia il consumo di token nella tua organizzazione con suddivisioni dettagliate per modello, workspace e livello di servizio con l'endpoint /v1/organizations/usage_report/messages.

Concetti chiave

Bucket temporali: Aggrega i dati di utilizzo in intervalli fissi (1m, 1h, o 1d)
Tracciamento token: Misura token di input non memorizzati, input memorizzati, creazione cache e token di output
Filtraggio e raggruppamento: Filtra per chiave API, workspace, modello, livello di servizio o finestra di contesto, e raggruppa i risultati per queste dimensioni
Utilizzo strumenti server: Traccia l'utilizzo di strumenti lato server come la ricerca web

Per dettagli completi sui parametri e schemi di risposta, vedi il riferimento API di Utilizzo.

Esempi di base

Utilizzo giornaliero per modello

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" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ADMIN_API_KEY"

Utilizzo orario con filtraggio

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-sonnet-4-5-20250929&\
service_tiers[]=batch&\
context_window[]=0-200k&\
bucket_width=1h" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ADMIN_API_KEY"

Filtra utilizzo per chiavi API e workspace

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" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ADMIN_API_KEY"

Per recuperare gli ID delle chiavi API della tua organizzazione, usa l'endpoint Elenca Chiavi API.

Per recuperare gli ID dei workspace della tua organizzazione, usa l'endpoint Elenca Workspace, o trova gli ID dei workspace della tua organizzazione nella Console Anthropic.

Limiti di granularità temporale

Granularità	Limite Predefinito	Limite Massimo	Caso d'Uso
`1m`	60 bucket	1440 bucket	Monitoraggio in tempo reale
`1h`	24 bucket	168 bucket	Modelli giornalieri
`1d`	7 bucket	31 bucket	Report settimanali/mensili

API dei Costi

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ù piccole (centesimi)
Tipi di costo: Traccia utilizzo token, ricerca web e costi di esecuzione codice
Raggruppamento: Raggruppa i costi per workspace o descrizione per suddivisioni dettagliate
Bucket temporali: Solo granularità giornaliera (1d)

Per dettagli completi sui parametri e schemi di risposta, vedi il riferimento API dei Costi.

I costi del Livello Priorità utilizzano un modello di fatturazione diverso e non sono inclusi nell'endpoint dei costi. Traccia l'utilizzo del Livello Priorità attraverso l'endpoint di utilizzo invece.

Esempio di base

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" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ADMIN_API_KEY"

Paginazione

Entrambi gli endpoint supportano la paginazione per grandi set di dati:

Fai la tua richiesta iniziale
Se has_more è true, usa il valore next_page nella tua prossima richiesta
Continua finché has_more è false

# 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" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ADMIN_API_KEY"

# La risposta include: "has_more": true, "next_page": "page_xyz..."

# Prossima richiesta 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..." \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ADMIN_API_KEY"

Casi d'uso comuni

Esplora implementazioni dettagliate in anthropic-cookbook:

Report di utilizzo giornalieri: Traccia le tendenze del consumo di token
Attribuzione dei costi: Alloca le spese per workspace per riaddebiti
Efficienza della cache: Misura e ottimizza il caching dei prompt
Monitoraggio del budget: Configura avvisi per soglie di spesa
Esportazione CSV: Genera report per i team finanziari

Domande frequenti

Quanto sono freschi i dati?

I dati di utilizzo e costi appaiono tipicamente entro 5 minuti dal completamento della richiesta API, anche se occasionalmente i ritardi possono essere più lunghi.

Qual è la frequenza di polling raccomandata?

L'API supporta il polling una volta al minuto per uso sostenuto. Per brevi raffiche (ad es., download di dati paginati), è accettabile un polling più frequente. Memorizza nella cache i risultati per dashboard che necessitano aggiornamenti frequenti.

Come tracciare l'utilizzo dell'esecuzione codice?

I costi dell'esecuzione codice appaiono nell'endpoint dei costi raggruppati sotto Code Execution Usage nel campo descrizione. L'esecuzione codice non è inclusa nell'endpoint di utilizzo.

Come tracciare l'utilizzo del Livello Priorità?

Filtra o raggruppa per service_tier nell'endpoint di utilizzo e cerca il valore priority. I costi del Livello Priorità non sono disponibili nell'endpoint dei costi.

Cosa succede con l'utilizzo del Workbench?

L'utilizzo API dal Workbench non è associato a una chiave API, quindi api_key_id sarà null anche quando si raggruppa per quella dimensione.

Come viene rappresentato il workspace predefinito?

L'utilizzo e i costi attribuiti al workspace predefinito hanno un valore null per workspace_id.

Come ottenere suddivisioni dei costi per utente per Claude Code?

Usa l'API Analytics di Claude Code, che fornisce costi stimati per utente e metriche di produttività senza le limitazioni di prestazioni della suddivisione dei costi per molte chiavi API. Per l'utilizzo generale dell'API con molte chiavi, usa l'API di Utilizzo per tracciare il consumo di token come proxy dei costi.

Vedi anche

Le API di Utilizzo e Costi possono essere utilizzate per aiutarti a fornire una migliore esperienza per i tuoi utenti, aiutarti a gestire i costi e preservare il tuo limite di velocità. Scopri di più su alcune di queste altre funzionalità:

Panoramica API Admin
Riferimento API Admin
Prezzi
Caching dei prompt - Ottimizza i costi con il caching
Elaborazione batch - 50% di sconto sulle richieste batch
Limiti di velocità - Comprendi i livelli di utilizzo