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 Anthropic.

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 di 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 Anthropic.

​
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

Grafana Cloud

Integrazione senza agenti per una facile osservabilità LLM con dashboard e avvisi pronti all’uso

Honeycomb

Query avanzate e visualizzazione attraverso OpenTelemetry

​
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 nella cache, input memorizzati nella cache, 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 i dettagli completi dei parametri e gli 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-20250514&\
service_tiers[]=batch&\
context_window[]=0-200k&\
bucket_width=1h" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ADMIN_API_KEY"

​
Limiti di granularità temporale

GranularitàLimite PredefinitoLimite MassimoCaso d’Uso
1m60 bucket1440 bucketMonitoraggio in tempo reale
1h24 bucket168 bucketModelli giornalieri
1d7 bucket31 bucketReport settimanali/mensili

​
API dei Costi

Recupera le 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 i costi di utilizzo token, ricerca web ed esecuzione codice
  • Raggruppamento: Raggruppa i costi per workspace o descrizione per suddivisioni dettagliate
  • Bucket temporali: Solo granularità giornaliera (1d)

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

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

​
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:

  1. Fai la tua richiesta iniziale
  2. Se has_more è true, usa il valore next_page nella tua prossima richiesta
  3. 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 di consumo dei token
  • Attribuzione dei costi: Alloca le spese per workspace per chargeback
  • Efficienza della cache: Misura e ottimizza il caching dei prompt
  • Monitoraggio del budget: Configura 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 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), un polling più frequente è accettabile. Memorizza nella cache i risultati per dashboard che necessitano aggiornamenti frequenti.

​
Come tracciare l’utilizzo dell’esecuzione codice?

I costi di 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 di Priorità?

Filtra o raggruppa per service_tier nell’endpoint di utilizzo e cerca il valore priority. I costi del Livello di 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.

​
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à: