--- title: Usage and Cost API url: https://platform.claude.com/docs/de/manage-claude/usage-cost-api description: Greife programmatisch auf die API-Nutzungs- und Kostendaten deiner Organisation mit der Usage and Cost Admin API zu. --- **Die Admin API ist für Einzelkonten nicht verfügbar.** Um mit Teamkollegen zusammenzuarbeiten und Mitglieder hinzuzufügen, richte deine Organisation auf der Seite [Organization](https://platform.claude.com/settings/organization) (`platform.claude.com/settings/organization`) in der Claude Console ein. Die Usage and Cost Admin API bietet programmatischen und detaillierten Zugriff auf historische API-Nutzungs- und Kostendaten deiner Organisation. Diese Daten ähneln den Informationen, die auf der Seite [Usage](https://platform.claude.com/usage) (`platform.claude.com/usage`) und der Seite [Cost](https://platform.claude.com/cost) (`platform.claude.com/cost`) in der Claude Console verfügbar sind. Diese API ermöglicht es dir, deine Claude-Implementierungen besser zu überwachen, zu analysieren und zu optimieren: * **Genaue Nutzungsverfolgung:** Erhalte präzise Token-Zählungen und Nutzungsmuster, anstatt dich ausschließlich auf die Token-Zählung in Antworten zu verlassen * **Kostenabgleich:** Gleiche interne Aufzeichnungen mit der Anthropic-Abrechnung für Finanz- und Buchhaltungsteams ab * **Produktleistung und -verbesserung:** Überwache die Produktleistung und messe dabei, ob Änderungen am System es verbessert haben, oder richte Benachrichtigungen ein * **Optimierung des [Ratenlimits](https://platform.claude.com/docs/de/api/rate-limits):** Optimiere Funktionen wie [Prompt-Caching](https://platform.claude.com/docs/de/build-with-claude/prompt-caching) oder bestimmte Prompts, um deine zugewiesene Kapazität optimal zu nutzen. * **Erweiterte Analyse:** Führe tiefergehende Datenanalysen durch, als sie in der Console verfügbar sind **Admin-API-Zugangsdaten erforderlich.** Diese Endpunkte sind Teil der Admin API. Du kannst auf sie mit einem [Admin-API-Key](https://platform.claude.com/docs/de/manage-claude/admin-api-keys), einem OAuth-Token mit dem Scope `org:admin` oder einem persönlichen Key bzw. Service-Account-Key zugreifen, der nicht auf einen Workspace beschränkt ist; Workspace-API-Keys funktionieren nicht. Siehe [Authentifizierung](https://platform.claude.com/docs/de/manage-claude/admin-api#authentication) für Details. Claude Enterprise-Organisationen verwenden stattdessen einen Analytics-API-Key mit einer anderen API; siehe [Welche API brauchst du?](https://platform.claude.com/docs/de/manage-claude/usage-cost-api#which-api-do-you-need). **Claude Platform on AWS:** Die programmatischen Usage and Cost API-Endpunkte sind derzeit nicht verfügbar. Sieh dir Nutzungs- und Kostendaten stattdessen auf den Seiten **Usage** und **Cost** in der Claude Console an. ## Welche API brauchst du? Anthropic stellt Kosten- und Nutzungsberichte über zwei APIs bereit, je nachdem, welches Claude-Produkt deine Organisation verwaltet: | Deine Organisation | API | Key-Typ | | -------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Claude Console (Claude Platform) | Die auf dieser Seite beschriebene Usage and Cost Admin API | Admin-API-Key (`sk-ant-admin01-...`) oder eine andere [Admin-API-Anmeldeinformation](https://platform.claude.com/docs/de/manage-claude/admin-api#authentication) | | Claude Enterprise (claude.ai) | Die Kosten- und Nutzungsendpunkte der [Claude Enterprise Analytics API](https://platform.claude.com/docs/de/api/beta/organization/analytics) | Analytics-API-Key | Übergeordnete Claude Enterprise-Organisationen erscheinen nicht in der Claude Console und besitzen keine Admin-API-Keys, daher ist für sie der Analytics-API-Key der einzige Weg zu diesen Daten. Siehe [Analytics APIs](https://platform.claude.com/docs/de/manage-claude/analytics-api), um zu erfahren, wie du jeden Key-Typ erstellst und für welche Pläne die Claude Enterprise-Kostendaten gelten. ## Partnerlösungen Führende Observability-Plattformen bieten einsatzbereite Integrationen zur Überwachung deiner Claude API-Nutzung und -Kosten, ohne dass du eigenen Code schreiben musst. Diese Integrationen bieten Dashboards, Benachrichtigungen und Analysen, die dir helfen, deine API-Nutzung effektiv zu verwalten. Cloud-Intelligence-Plattform zur Verfolgung und Prognose von Kosten LLM-Observability mit automatischem Tracing und Monitoring Agentenlose Integration für einfache LLM-Observability mit sofort einsatzbereiten Dashboards und Benachrichtigungen FinOps-Plattform für Cloud- und KI-Kostenmanagement Erweiterte Abfragen und Visualisierung über OpenTelemetry Zuordnung von Nutzung und Kosten zu Jira-Arbeitselementen FinOps-Plattform für LLM-Kosten- und Nutzungs-Observability ## Schnellstart Rufe die tägliche Nutzung deiner Organisation für die letzten 7 Tage ab: ```bash cURL 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" \ -H "anthropic-version: 2023-06-01" \ -H "x-api-key: $ANTHROPIC_ADMIN_KEY" ``` **Setze einen User-Agent-Header für Integrationen** Wenn du eine Integration erstellst, setze deinen User-Agent-Header, um Anthropic zu helfen, Nutzungsmuster zu verstehen: ```text wrap User-Agent: YourApp/1.0.0 (https://yourapp.com) ``` ## Usage API Verfolge den Token-Verbrauch in deiner gesamten Organisation mit detaillierten Aufschlüsselungen nach Modell, Workspace und Service-Tier über den Endpunkt `/v1/organizations/usage_report/messages`. ### Wichtige Konzepte * **Zeit-Buckets:** Aggregiere Nutzungsdaten in festen Intervallen (`1m`, `1h` oder `1d`) * **Token-Verfolgung:** Messe nicht gecachte Eingabe-, gecachte Eingabe-, Cache-Erstellungs- und Ausgabe-Token * **Filtern & Gruppieren:** Filtere nach API-Key, Workspace, Modell, Service-Tier, Kontextfenster, [Datenresidenz](https://platform.claude.com/docs/de/manage-claude/data-residency) oder Geschwindigkeit und gruppiere Ergebnisse nach diesen Dimensionen * **Server-Tool-Nutzung:** Verfolge die Nutzung serverseitiger Tools wie der Websuche Vollständige Parameterdetails und Antwortschemata findest du in der [Usage API-Referenz](https://platform.claude.com/docs/de/api/beta/organization/usage_report/retrieve_messages). ### Grundlegende Beispiele #### Tägliche Nutzung nach Modell ```bash cURL 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" \ -H "anthropic-version: 2023-06-01" \ -H "x-api-key: $ANTHROPIC_ADMIN_KEY" ``` #### Stündliche Nutzung mit Filterung ```bash cURL 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-opus-5-5&\ service_tiers[]=batch&\ context_window[]=0-200k&\ bucket_width=1h" \ -H "anthropic-version: 2023-06-01" \ -H "x-api-key: $ANTHROPIC_ADMIN_KEY" ``` #### Nutzung nach API-Keys und Workspaces filtern ```bash cURL 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" \ -H "anthropic-version: 2023-06-01" \ -H "x-api-key: $ANTHROPIC_ADMIN_KEY" ``` Um die API-Key-IDs deiner Organisation abzurufen, verwende den Endpunkt [List API Keys](https://platform.claude.com/docs/de/api/organization/api_keys/list). Um die Workspace-IDs deiner Organisation abzurufen, verwende den Endpunkt [List Workspaces](https://platform.claude.com/docs/de/api/organization/workspaces/list) oder finde die Workspace-IDs deiner Organisation in der Claude Console. #### Datenresidenz Verfolge deine [Datenresidenz-Kontrollen](https://platform.claude.com/docs/de/manage-claude/data-residency), indem du die Nutzung mit der Dimension `inference_geo` gruppierst und filterst. Dies ist nützlich, um das geografische Routing in deiner gesamten Organisation zu überprüfen. ```bash cURL curl "https://api.anthropic.com/v1/organizations/usage_report/messages?\ starting_at=2026-02-01T00:00:00Z&\ ending_at=2026-02-08T00:00:00Z&\ group_by[]=inference_geo&\ group_by[]=model&\ bucket_width=1d" \ -H "anthropic-version: 2023-06-01" \ -H "x-api-key: $ANTHROPIC_ADMIN_KEY" ``` Du kannst auch nach einer bestimmten Geo filtern. Gültige Werte sind `global`, `us` und `not_available`: ```bash cURL curl "https://api.anthropic.com/v1/organizations/usage_report/messages?\ starting_at=2026-02-01T00:00:00Z&\ ending_at=2026-02-08T00:00:00Z&\ inference_geos[]=us&\ group_by[]=model&\ bucket_width=1d" \ -H "anthropic-version: 2023-06-01" \ -H "x-api-key: $ANTHROPIC_ADMIN_KEY" ``` Modelle, die vor Februar 2026 veröffentlicht wurden (vor Claude Opus 4.6 und Claude Sonnet 4.6), unterstützen den Anfrageparameter `inference_geo` nicht, daher geben ihre Nutzungsberichte für diese Dimension `"not_available"` zurück. Du kannst `not_available` als Filterwert in `inference_geos[]` verwenden, um diese Modelle gezielt anzusprechen. #### Fast Mode Verfolge die Nutzung des [Fast Mode](https://platform.claude.com/docs/de/build-with-claude/fast-mode), indem du mit der Dimension `speed` gruppierst und filterst. Dies ist nützlich, um die Nutzung im Standard- gegenüber dem Fast Mode zu überwachen. ```bash cURL curl "https://api.anthropic.com/v1/organizations/usage_report/messages?\ starting_at=2026-02-01T00:00:00Z&\ ending_at=2026-02-08T00:00:00Z&\ group_by[]=speed&\ group_by[]=model&\ bucket_width=1d" \ -H "anthropic-version: 2023-06-01" \ -H "x-api-key: $ANTHROPIC_ADMIN_KEY" ``` Du kannst auch nach einer bestimmten Geschwindigkeit filtern. Gültige Werte sind `standard` und `fast`: ```bash cURL curl "https://api.anthropic.com/v1/organizations/usage_report/messages?\ starting_at=2026-02-01T00:00:00Z&\ ending_at=2026-02-08T00:00:00Z&\ speeds[]=fast&\ group_by[]=model&\ bucket_width=1d" \ -H "anthropic-version: 2023-06-01" \ -H "x-api-key: $ANTHROPIC_ADMIN_KEY" ``` ### Limits der Zeitgranularität | Granularität | Standardlimit | Maximales Limit | Anwendungsfall | | ------------ | ------------- | --------------- | -------------------------------- | | `1m` | 60 Buckets | 1.440 Buckets | Echtzeit-Monitoring | | `1h` | 24 Buckets | 168 Buckets | Tägliche Muster | | `1d` | 7 Buckets | 31 Buckets | Wöchentliche/monatliche Berichte | ## Cost API Rufe Kostenaufschlüsselungen auf Service-Ebene in USD über den Endpunkt `/v1/organizations/cost_report` ab. ### Wichtige Konzepte * **Währung:** Alle Kosten in USD, angegeben als Dezimalzeichenketten in der kleinsten Einheit (Cent) * **Kostenarten:** Verfolge Kosten für Token-Nutzung, Websuche und Codeausführung * **Gruppierung:** Gruppiere Kosten nach Workspace oder Beschreibung für detaillierte Aufschlüsselungen. Bei Gruppierung nach `description` enthalten die Antworten geparste Felder wie `model` und `inference_geo` * **Zeit-Buckets:** Nur tägliche Granularität (`1d`) Vollständige Parameterdetails und Antwortschemata findest du in der [Cost API-Referenz](https://platform.claude.com/docs/de/api/beta/organization/cost_report/retrieve). Priority Tier-Kosten verwenden ein anderes Abrechnungsmodell und sind nicht im Kostenendpunkt enthalten. Verfolge die Priority Tier-Nutzung stattdessen über den Nutzungsendpunkt. ### Grundlegendes Beispiel ```bash cURL 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" \ -H "anthropic-version: 2023-06-01" \ -H "x-api-key: $ANTHROPIC_ADMIN_KEY" ``` ## Paginierung Beide Endpunkte unterstützen Paginierung für große Datensätze: 1. Stelle deine erste Anfrage. 2. Wenn `has_more` `true` ist, verwende den Wert `next_page` in deiner nächsten Anfrage. 3. Fahre fort, bis `has_more` `false` ist. ```bash cURL # 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" \ -H "anthropic-version: 2023-06-01" \ -H "x-api-key: $ANTHROPIC_ADMIN_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..." \ -H "anthropic-version: 2023-06-01" \ -H "x-api-key: $ANTHROPIC_ADMIN_KEY" ``` ## Häufige Anwendungsfälle Erkunde detaillierte Implementierungen im [Claude Cookbook](https://platform.claude.com/cookbook): * **Tägliche Nutzungsberichte:** Verfolge Trends beim Token-Verbrauch * **Kostenzuordnung:** Ordne Ausgaben nach Workspace für interne Verrechnungen zu * **Cache-Effizienz:** Messe und optimiere Prompt-Caching * **Budgetüberwachung:** Richte Benachrichtigungen für Ausgabenschwellen ein * **CSV-Export:** Erstelle Berichte für Finanzteams ## Häufig gestellte Fragen ### Wie aktuell sind die Daten? Nutzungs- und Kostendaten erscheinen in der Regel innerhalb von 5 Minuten nach Abschluss der API-Anfrage, wobei Verzögerungen gelegentlich länger sein können. ### Welche Polling-Frequenz wird empfohlen? Die API unterstützt bei dauerhafter Nutzung ein Polling einmal pro Minute. Für kurze Bursts (zum Beispiel beim Herunterladen paginierter Daten) ist häufigeres Polling akzeptabel. Cache Ergebnisse für Dashboards, die häufige Aktualisierungen benötigen. ### Wie verfolge ich die Nutzung der Codeausführung? Kosten für die Codeausführung erscheinen im Kostenendpunkt gruppiert unter `Code Execution Usage` im Beschreibungsfeld. Die Codeausführung ist nicht im Nutzungsendpunkt enthalten. ### Wie verfolge ich die Priority Tier-Nutzung? Filtere oder gruppiere im Nutzungsendpunkt nach `service_tier` und suche nach dem Wert `priority`. Priority Tier-Kosten sind im Kostenendpunkt nicht verfügbar. ### Was passiert mit der playground-Nutzung? API-Nutzung aus dem playground in der Claude Console (und aus der veralteten Workbench davor) ist keinem API-Key zugeordnet, daher ist `api_key_id` `null`, selbst wenn nach dieser Dimension gruppiert wird. ### 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? Verwende die [Claude Code Analytics API](https://platform.claude.com/docs/de/manage-claude/claude-code-analytics-api), die geschätzte Kosten pro Benutzer und Produktivitätsmetriken bereitstellt, ohne die Leistungseinschränkungen, die bei der Aufschlüsselung von Kosten nach vielen API-Keys entstehen. Für allgemeine API-Nutzung mit vielen Keys verwende die [Usage API](https://platform.claude.com/docs/de/manage-claude/usage-cost-api#usage-api), um den Token-Verbrauch als Kosten-Proxy zu verfolgen. ## Siehe auch Verwende die Usage and Cost APIs, um deinen Benutzern ein besseres Erlebnis zu bieten, Kosten zu verwalten und dein Ratenlimit zu schonen. Erfahre mehr über einige dieser anderen Funktionen: * [Admin API](https://platform.claude.com/docs/de/manage-claude/admin-api) * [Admin API-Referenz](https://platform.claude.com/docs/de/api/beta/organization) * [Analytics APIs](https://platform.claude.com/docs/de/manage-claude/analytics-api) - Welche Analytics API und welchen Key-Typ deine Organisation benötigt * [Preise](https://platform.claude.com/docs/de/about-claude/pricing) * [Prompt-Caching](https://platform.claude.com/docs/de/build-with-claude/prompt-caching) - Optimiere Kosten mit Caching * [Batch-Verarbeitung](https://platform.claude.com/docs/de/build-with-claude/batch-processing) - 50 % Rabatt auf Batch-Anfragen * [Ratenlimits](https://platform.claude.com/docs/de/api/rate-limits) - Verstehe die Nutzungsstufen * [Rate Limits API](https://platform.claude.com/docs/de/manage-claude/rate-limits-api) - Lies deine konfigurierten Ratenlimits aus * [Datenresidenz](https://platform.claude.com/docs/de/manage-claude/data-residency) - Steuere die Inferenz-Geografie