Nutzungs- und Kosten-API

Die Nutzungs- und Kosten-Admin-API bietet programmatischen und granularen Zugriff auf historische API-Nutzungs- und Kostendaten für Ihre Organisation. Diese Daten sind ähnlich den Informationen, die auf den Nutzungs- und Kosten-Seiten 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 ausschließlich auf die Zählung von Antwort-Token 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 es verbessert haben, oder richten Sie Benachrichtigungen ein
• Ratenlimit- und Priority Tier-Optimierung: Optimieren Sie Funktionen wie Prompt-Caching oder spezifische Prompts, um das Beste aus Ihrer zugewiesenen Kapazität zu machen, oder kaufen Sie dedizierte Kapazität.
• Erweiterte Analyse: Führen Sie tiefere Datenanalysen durch, als in der Console verfügbar sind

Partner-Lösungen

Führende Observability-Plattformen bieten sofort einsatzbereite Integrationen zur Überwachung Ihrer Claude-API-Nutzung und -Kosten, ohne benutzerdefinierten Code zu schreiben. Diese Integrationen bieten Dashboards, Benachrichtigungen und Analysen, um Ihnen bei der effektiven Verwaltung Ihrer API-Nutzung zu helfen.

Schnellstart

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

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)

Nutzungs-API

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

Schlüsselkonzepte

• Zeit-Buckets: Aggregieren Sie Nutzungsdaten in festen Intervallen (1m, 1h oder 1d)
• Token-Verfolgung: Messen Sie nicht-gecachte Eingabe-, gecachte Eingabe-, Cache-Erstellungs- und Ausgabe-Token
• Filterung & Gruppierung: Filtern Sie nach API-Schlüssel, Arbeitsbereich, Modell, Service-Tier oder Kontextfenster und gruppieren Sie Ergebnisse nach diesen Dimensionen
• Server-Tool-Nutzung: Verfolgen Sie die Nutzung von serverseitigen Tools wie Websuche

Für vollständige Parameterdetails und Antwort-Schemas siehe die Nutzungs-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 Arbeitsbereichen 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

Kosten-API

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

Schlüsselkonzepte

• Währung: Alle Kosten in USD, berichtet als Dezimalstrings in kleinsten Einheiten (Cents)
• Kostenarten: Verfolgen Sie Token-Nutzung, Websuche und Code-Ausführungskosten
• Gruppierung: Gruppieren Sie Kosten nach Arbeitsbereich oder Beschreibung für detaillierte Aufschlüsselungen
• Zeit-Buckets: Nur tägliche Granularität (1d)

Für vollständige Parameterdetails und Antwort-Schemas siehe die Kosten-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"

Paginierung

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

1. Stellen Sie Ihre erste Anfrage
2. Wenn has_more true ist, verwenden Sie den next_page-Wert 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"

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

# Nächste Anfrage mit Paginierung
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 anthropic-cookbook:

• Tägliche Nutzungsberichte: Verfolgen Sie Token-Verbrauchstrends
• Kostenzuordnung: Ordnen Sie Ausgaben nach Arbeitsbereich 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.

Was ist die empfohlene Abfragefrequenz?

Die API unterstützt Abfragen einmal pro Minute für anhaltende Nutzung. Für kurze Stöße (z.B. Herunterladen paginierter Daten) sind häufigere 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 Kosten-Endpunkt gruppiert unter Code Execution Usage im Beschreibungsfeld. Code-Ausführung ist nicht im Nutzungs-Endpunkt enthalten.

Wie verfolge ich die Priority Tier-Nutzung?

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

Was passiert mit Workbench-Nutzung?

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

Wie wird der Standard-Arbeitsbereich dargestellt?

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

Siehe auch

Die Nutzungs- und Kosten-APIs können verwendet werden, um Ihnen zu helfen, eine bessere Erfahrung für Ihre Benutzer zu liefern, Ihnen bei der Kostenverwaltung zu helfen und Ihr Ratenlimit zu bewahren. Erfahren Sie mehr über einige dieser anderen Funktionen:

• Admin-API-Übersicht
• Admin-API-Referenz
• Preise
• Prompt-Caching - Optimieren Sie Kosten mit Caching
• Batch-Verarbeitung - 50% Rabatt auf Batch-Anfragen
• Ratenlimits - Verstehen Sie Nutzungsstufen