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
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, o1d) - 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 valorenext_pagenella 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