The Admin API is unavailable for individual accounts. To collaborate with teammates and add members, set up your organization in Console → Settings → Organization.
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
  • 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
Admin-API-Schlüssel erforderlichDiese API ist Teil der Admin-API. Diese Endpunkte erfordern einen Admin-API-Schlüssel (beginnend mit sk-ant-admin...), der sich von Standard-API-Schlüsseln unterscheidet. Nur Organisationsmitglieder mit der Admin-Rolle können Admin-API-Schlüssel über die Anthropic Console bereitstellen.

​
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.

Datadog

LLM-Observability mit automatischem Tracing und Monitoring

Grafana Cloud

Agentenlose Integration für einfache LLM-Observability mit sofort einsatzbereiten Dashboards und Benachrichtigungen

Honeycomb

Erweiterte Abfragen und Visualisierung durch OpenTelemetry

​
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"
Setzen Sie einen User-Agent-Header für IntegrationenWenn Sie eine Integration erstellen, setzen Sie Ihren User-Agent-Header, um uns zu helfen, Nutzungsmuster zu verstehen:
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-20250514&\
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"
Um die API-Schlüssel-IDs Ihrer Organisation abzurufen, verwenden Sie den API-Schlüssel auflisten-Endpunkt.Um die Arbeitsbereich-IDs Ihrer Organisation abzurufen, verwenden Sie den Arbeitsbereiche auflisten-Endpunkt oder finden Sie die Arbeitsbereich-IDs Ihrer Organisation in der Anthropic Console.

​
Zeitgranularitätslimits

GranularitätStandard-LimitMaximum-LimitAnwendungsfall
1m60 Buckets1440 BucketsEchtzeit-Monitoring
1h24 Buckets168 BucketsTägliche Muster
1d7 Buckets31 BucketsWöchentliche/monatliche Berichte

​
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, gemeldet 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.
Priority Tier-Kosten verwenden ein anderes Abrechnungsmodell und sind nicht im Kosten-Endpunkt enthalten. Verfolgen Sie stattdessen die Priority Tier-Nutzung über den Nutzungs-Endpunkt.

​
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-Monitoring: 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 nachhaltige Nutzung. Für kurze Bursts (z.B. Download 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 aus 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: