Verwaltung und Überwachung

Nutzungs- und Kosten-API

Greifen Sie programmatisch auf die API-Nutzungs- und Kostendaten Ihrer Organisation mit der Nutzungs- und Kosten-Admin-API zu.

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

Admin-API-Schlüssel erforderlich

Diese 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 Claude 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 automatischer Verfolgung und Überwachung

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 Integrationen

Wenn 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-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"

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ätsgrenzen

Granularität	Standard-Limit	Maximum-Limit	Anwendungsfall
`1m`	60 Buckets	1440 Buckets	Echtzeitüberwachung
`1h`	24 Buckets	168 Buckets	Tägliche Muster
`1d`	7 Buckets	31 Buckets	Wö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, 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.

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:

Stellen Sie Ihre erste Anfrage
Wenn has_more true ist, verwenden Sie den next_page-Wert in Ihrer nächsten Anfrage
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

Verwaltung und Überwachung

Nutzungs- und Kosten-API

Greifen Sie programmatisch auf die API-Nutzungs- und Kostendaten Ihrer Organisation mit der Nutzungs- und Kosten-Admin-API zu.

The Admin API is unavailable for individual accounts. To collaborate with teammates and add members, set up your organization in Console → Settings → Organization.

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 erforderlich

Partner-Lösungen

Datadog

LLM-Observability mit automatischer Verfolgung und Überwachung

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 Integrationen

Wenn 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-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"

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ätsgrenzen

Granularität	Standard-Limit	Maximum-Limit	Anwendungsfall
`1m`	60 Buckets	1440 Buckets	Echtzeitüberwachung
`1h`	24 Buckets	168 Buckets	Tägliche Muster
`1d`	7 Buckets	31 Buckets	Wö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, 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.

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:

Stellen Sie Ihre erste Anfrage
Wenn has_more true ist, verwenden Sie den next_page-Wert in Ihrer nächsten Anfrage
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?

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

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