Usage and Cost API

Die Usage & Cost Admin API bietet programmatischen und granularen Zugriff auf historische API-Nutzungs- und Kostendaten für Ihre Organisation. Diese Daten ähneln den Informationen, die auf den Seiten Usage und Cost der Claude Console verfügbar sind.

Diese API ermöglicht es Ihnen, Ihre Claude-Implementierungen besser zu überwachen, zu analysieren und zu optimieren:

• Genaue Nutzungsverfolgung: Erhalten Sie präzise Token-Zählungen und Nutzungsmuster, anstatt sich nur auf die Zählung von Response-Tokens zu verlassen
• Kostenabstimmung: Gleichen Sie interne Aufzeichnungen mit der Anthropic-Abrechnung für Finanz- und Buchhaltungsteams ab
• Produktleistung und Verbesserung: Überwachen Sie die Produktleistung und messen Sie, ob Änderungen am System sie verbessert haben, oder richten Sie Benachrichtigungen ein
• Rate Limit und Priority Tier Optimierung: Optimieren Sie Funktionen wie Prompt Caching oder spezifische Prompts, um das Beste aus Ihrer zugewiesenen Kapazität herauszuholen, oder kaufen Sie dedizierte Kapazität.
• Erweiterte Analyse: Führen Sie tiefere Datenanalysen durch als in der Console verfügbar

Partner-Lösungen

Führende Observability-Plattformen bieten einsatzbereite Integrationen zur Überwachung Ihrer Claude API-Nutzung und Kosten, ohne benutzerdefinierten Code zu schreiben. Diese Integrationen bieten Dashboards, Benachrichtigungen und Analysen, um Ihre API-Nutzung effektiv zu verwalten.

Schnellstart

Rufen Sie die tägliche Nutzung Ihrer Organisation für die letzten 7 Tage ab:

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"

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

Usage API

Verfolgen Sie den Token-Verbrauch in Ihrer Organisation mit detaillierten Aufschlüsselungen nach Modell, Workspace und Service Tier mit dem Endpunkt /v1/organizations/usage_report/messages.

Wichtige Konzepte

• Zeitbuckets: Aggregieren Sie Nutzungsdaten in festen Intervallen (1m, 1h oder 1d)
• Token-Verfolgung: Messen Sie unkachedierte Eingabe, gecachte Eingabe, Cache-Erstellung und Output-Tokens
• Filterung & Gruppierung: Filtern Sie nach API-Schlüssel, Workspace, Modell, Service Tier, Kontextfenster oder Datenspeicherort, und gruppieren Sie Ergebnisse nach diesen Dimensionen
• Server-Tool-Nutzung: Verfolgen Sie die Nutzung von serverseitigen Tools wie Web-Suche

Für vollständige Parameterdetails und Response-Schemas siehe die Usage API-Referenz.

Grundlegende Beispiele

Tägliche Nutzung nach Modell

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"

Stündliche Nutzung mit Filterung

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

Nutzung nach API-Schlüsseln und Workspaces filtern

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"

Datenspeicherort

Verfolgen Sie Ihre Datenspeicherort-Kontrollen, indem Sie die Nutzung mit der Dimension inference_geo gruppieren und filtern. Dies ist nützlich, um die geografische Weiterleitung in Ihrer Organisation zu überprüfen.

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

Sie können auch auf ein bestimmtes Geo filtern. Gültige Werte sind global, us und not_available:

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

Zeitgranularitätsgrenzen

Cost API

Rufen Sie Service-Level-Kostenaufschlüsselungen in USD mit dem Endpunkt /v1/organizations/cost_report ab.

Wichtige Konzepte

• Währung: Alle Kosten in USD, angegeben als Dezimalzeichenketten in kleinsten Einheiten (Cent)
• Kostentypen: Verfolgen Sie Token-Nutzung, Web-Suche und Code-Ausführungskosten
• Gruppierung: Gruppieren Sie Kosten nach Workspace oder Beschreibung für detaillierte Aufschlüsselungen. Bei Gruppierung nach description enthalten Responses analysierte Felder wie model und inference_geo
• Zeitbuckets: Nur tägliche Granularität (1d)

Für vollständige Parameterdetails und Response-Schemas siehe die Cost API-Referenz.

Grundlegendes Beispiel

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"

Pagination

Beide Endpunkte unterstützen Pagination für große Datensätze:

1. Stellen Sie Ihre erste Anfrage
2. Wenn has_more true ist, verwenden Sie den Wert next_page in Ihrer nächsten Anfrage
3. Fahren Sie fort, bis has_more false ist

# Erste Anfrage
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"

# Response enthält: "has_more": true, "next_page": "page_xyz..."

# Nächste Anfrage mit Pagination
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"

Häufige Anwendungsfälle

Erkunden Sie detaillierte Implementierungen im Claude Cookbook:

• Tägliche Nutzungsberichte: Verfolgen Sie Token-Verbrauchstrends
• Kostenzuordnung: Ordnen Sie Ausgaben nach Workspace für Rückbelastungen zu
• Cache-Effizienz: Messen und optimieren Sie Prompt Caching
• Budget-Überwachung: Richten Sie Benachrichtigungen für Ausgabenschwellen ein
• CSV-Export: Generieren Sie Berichte für Finanzbuchhaltungsteams

Häufig gestellte Fragen

Wie aktuell sind die Daten?

Nutzungs- und Kostendaten erscheinen normalerweise innerhalb von 5 Minuten nach Abschluss der API-Anfrage, obwohl Verzögerungen gelegentlich länger sein können.

Wie oft sollte ich abfragen?

Die API unterstützt Abfragen einmal pro Minute für kontinuierliche Nutzung. Für kurze Bursts (z. B. das Herunterladen paginierter Daten) ist häufigeres Abfragen akzeptabel. Cachen Sie Ergebnisse für Dashboards, die häufige Updates benötigen.

Wie verfolge ich die Code-Ausführungsnutzung?

Code-Ausführungskosten erscheinen im Cost-Endpunkt, gruppiert unter Code Execution Usage im Beschreibungsfeld. Code-Ausführung ist nicht im Usage-Endpunkt enthalten.

Wie verfolge ich die Priority Tier-Nutzung?

Filtern oder gruppieren Sie nach service_tier im Usage-Endpunkt und suchen Sie nach dem Wert priority. Priority Tier-Kosten sind nicht im Cost-Endpunkt verfügbar.

Was passiert mit der Workbench-Nutzung?

API-Nutzung aus der Workbench ist nicht mit einem API-Schlüssel verknüpft, daher ist api_key_id null, auch wenn Sie nach dieser Dimension gruppieren.

Wie wird der Standard-Workspace dargestellt?

Nutzung und Kosten, die dem Standard-Workspace zugeordnet sind, haben einen null-Wert für workspace_id.

Wie erhalte ich Kostenaufschlüsselungen pro Benutzer für Claude Code?

Verwenden Sie die Claude Code Analytics API, die geschätzte Kosten pro Benutzer und Produktivitätsmetriken ohne die Leistungsbeschränkungen der Kostenaufschlüsselung nach vielen API-Schlüsseln bietet. Für allgemeine API-Nutzung mit vielen Schlüsseln verwenden Sie die Usage API, um Token-Verbrauch als Kosten-Proxy zu verfolgen.

Siehe auch

Die Usage und Cost APIs können verwendet werden, um eine bessere Erfahrung für Ihre Benutzer zu bieten, Ihnen bei der Verwaltung von Kosten zu helfen und Ihr Rate Limit zu bewahren. Erfahren Sie mehr über einige dieser anderen Funktionen:

• Admin API-Übersicht
• Admin API-Referenz
• Preisgestaltung
• Prompt Caching - Optimieren Sie Kosten mit Caching
• Batch-Verarbeitung - 50% Rabatt auf Batch-Anfragen
• Rate Limits - Verstehen Sie Nutzungsstufen
• Datenspeicherort - Kontrollieren Sie die Inferenz-Geografie