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 ähneln den Informationen, die auf den Seiten Nutzung und Kosten der Anthropic 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
• Optimierung von Ratenlimits und Priority Tier: Optimieren Sie Funktionen wie Prompt-Caching oder spezifische Prompts, um das Beste aus der 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 gebrauchsfertige 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 Antwortschemas 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-20250514&\
service_tiers[]=batch&\
context_window[]=0-200k&\
bucket_width=1h" \
  --header "anthropic-version: 2023-06-01" \
  --header "x-api-key: $ADMIN_API_KEY"

​

Zeitgranularitätslimits

​

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)
• Kostentypen: 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 Antwortschemas 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: Weisen 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 typischerweise innerhalb von 5 Minuten nach Abschluss der API-Anfrage, obwohl Verzögerungen gelegentlich länger sein können.

​

Was ist die empfohlene Polling-Frequenz?

Die API unterstützt Polling einmal pro Minute für anhaltende Nutzung. Für kurze Bursts (z.B. Herunterladen paginierter Daten) ist häufigeres Polling 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 wird api_key_id null sein, 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
• Preisgestaltung
• Prompt-Caching - Optimieren Sie Kosten mit Caching
• Batch-Verarbeitung - 50% Rabatt auf Batch-Anfragen
• Ratenlimits - Verstehen Sie Nutzungsstufen