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 Antwort-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 diese 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 der 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 Ausgabe-Tokens
• Filterung & Gruppierung: Filtern Sie nach API-Schlüssel, Workspace, Modell, Service Tier oder Kontextfenster 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-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"

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"

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, als Dezimalzeichenfolgen in kleinsten Einheiten (Cent) angegeben
• Kostentypen: Verfolgen Sie Token-Nutzung, Web-Suche und Code-Ausführungskosten
• Gruppierung: Gruppieren Sie Kosten nach Workspace oder Beschreibung für detaillierte Aufschlüsselungen
• 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 in anthropic-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 Finanzteams

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 häufig 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. Zwischenspeichern Sie Ergebnisse für Dashboards, die häufige Aktualisierungen 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 den Token-Verbrauch als Kosten-Proxy zu verfolgen.

Siehe auch

Die Usage und Cost APIs können verwendet werden, um Ihren Benutzern ein besseres Erlebnis zu bieten, Ihre Kosten zu verwalten 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