Einführung der Billable Usage API: Programmatische Kostentransparenz für Cloudflare

Bei der Agents Week geht es um einen Wandel, der bereits in vollem Gange ist: Agents schreiben Code, stellen Workers bereit und provisionieren in Ihrem Namen Infrastruktur. Dadurch verändert sich auch, welche Einblicke Sie benötigen. Wenn ein Programm in Ihrem Cloudflare-Konto Kosten verursacht, müssen Sie wissen, wofür diese anfallen – im Tagesverlauf, nach Produkt aufgeschlüsselt und in einem maschinenlesbares Format, das von einem anderen Programm verarbeitet werden kann. Für Menschen ist das Dashboard die richtige Lösung. Für Automatisierung ist es das nicht.

Deshalb führen wir für Self-Service-Konten eine neue Billable Usage API ein: Ein zentraler Endpunkt liefert Kosten- und Nutzungsdaten Ihres Kontos, aufgeschlüsselt nach Produkt und Servicezeitraum. Die API deckt sämtliche nutzungsbasierten Cloudflare-Produkte im Konto ab, darunter Workers, R2, D1, Workers AI, Vectorize, Images und Stream – alles mit nur einem Aufruf. Und wenn Sie bereits mit einer FinOps-Toolchain arbeiten, dürften Ihnen die Spaltennamen bekannt vorkommen.

curl https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/billable-usage \
  -H "Authorization: Bearer $CLOUDFLARE_API_TOKEN"

curl "https://api.cloudflare.com/client/v4/accounts/$ACCOUNT_ID/billable-usage?from=2026-02-01&to=2026-02-15" \
  -H "Authorization: Bearer $CLOUDFLARE_API_TOKEN"

Sie erhalten eine Rückmeldung mit einem HTTP 200 OK mit Content-Type: application/json und den Nutzungsdaten im Antworttext. Derzeit werden Nutzungs- und Kostendaten täglich aktualisiert, während wir daran arbeiten, diese künftig in nahezu Echtzeit bereitzustellen.

Was die API zurückliefert

Jede Zeile in der Antwort entspricht einem Abrechnungszeitraum für ein Produkt auf Ihrem Konto.

• ServiceName und ServiceFamilyName  – welches Produkt („Workers Standard“ unter der Familie „Workers“, „R2 Storage“ unter „R2“, usw.).
• ChargePeriodStart / ChargePeriodEnd — der Zeitraum, den diese Zeile abdeckt.
• PricingQuantity und ConsumedUnit — wie viel Sie genutzt haben, in der Maßeinheit, auf der wir abrechnen (GB-Monate, GB-Sekunden, Anfragen usw.).
• ContractedCost — wie viel dieser Zeitraum in BillingCurrency kostet.
• CumulatedPricingQuantity und CumulatedContractedCost – laufende Summen für den Abrechnungszeitraum.
• ZoneId / ZoneName – wenn die Nutzung einer bestimmten Zone zugeordnet wird.

Die meisten dieser Felder entsprechen direkt den Spalten der FinOps Open Cost and Usage Specification (FOCUS). Wenn Ihr Team bereits FOCUS-Daten eines anderen Anbieters verarbeitet, werden Ihnen die Feldnamen und ihre Bedeutung vertraut sein.

Antworten verwenden das standardisierte Cloudflare-API-Gehäuse — result ist ein Array von Zeilen, eine pro Produkt und Abrechnungszeitraum, zusammen mit success, errors, und messages.

{
  "result": [
    {
      "BillingCurrency": "USD",
      "BillingPeriodStart": "2025-02-01T00:00:00Z",
      "ChargePeriodStart": "2025-02-01T00:00:00Z",
      "ChargePeriodEnd": "2025-02-28T23:59:59Z",
      "ServiceName": "Workers Standard",
      "ServiceFamilyName": "Workers",
      "ConsumedQuantity": 150000,
      "ConsumedUnit": "GB-months",
      "ContractedCost": 0.75,
      "CumulatedContractedCost": 2.25
    }
  ],
  "success": true,
  "errors": [],
  "messages": []
}

Auf dem Weg zur vollständigen FOCUS-Konformität

Die Übernahme der FOCUS-Feldbezeichnungen war eine bewusste Entscheidung. AWS, Azure, Google Cloud, Oracle und eine stetig wachsende Zahl von SaaS-Anbietern stellen ihre Kosten- und Nutzungsdaten bereits im FOCUS-Format bereit. Auch alle etablierten FinOps- und Kostenmanagement-Tools unterstützen diesen Standard.Derzeit erfüllen wir die FOCUS-Spezifikation jedoch noch nicht vollständig: Einige der vorgeschriebenen Felder sind in der API-Antwort noch nicht enthalten. Die vollständige Konformität ist bereits eingeplant. Sehen Sie dies als ersten Meilenstein – heute ein vertrautes Datenmodell, als Nächstes vollständige FOCUS-Unterstützung.

Cloudflare-Kosten, neben den restlichen Cloud-Kosten: unsere Partnerschaft mit Vantage

Wir haben gemeinsam mit  Vantage eine native Cloudflare-Integration entwickelt. Vantage ist eine Plattform für das Management von Infrastrukturkosten, die Kosten- und Nutzungsdaten von mehr als 30 Anbietern aus den Bereichen KI, Cloud und SaaS zusammenführt. Die Daten werden in einer zentralen Ansicht für Reporting, Kostenzuordnung und Optimierung bereitgestellt. Mit dieser Integration fließen Ihre Cloudflare-Nutzungsdaten in dieselben Kostenberichte, Budgets und Kostenwarnungen ein, die Sie bereits für Ihre übrige Infrastruktur verwenden.

Vantage verbindet sich mit Cloudflare über ein API-Token mit ausschließlich Lesezugriff und der Berechtigung Billing Read. Nach der Verbindung ruft Vantage Ihre Billable-Usage-Daten täglich ab und schlüsselt sie nach Produkt (z. B. Workers und R2), Zone und Konto auf. So erkennen Sie, welche Produkte den größten Anteil an Ihren Kosten haben, und können diese den verantwortlichen Teams und Services zuordnen.

Einige der Workflows, die diese Integration unterstützt:

• Anbieterübergreifende Kostenzuordnung. Gruppieren Sie Ihre Cloudflare-Ausgaben nach Produkt, Zone und Konto und ordnen Sie sie anschließend mithilfe virtueller Tags Teams oder Produktlinien zu. So lassen sich Cloudflare-Kosten gemeinsam mit den Kosten von AWS, Azure und anderen Anbietern in einem einzigen Bericht auswerten.
• Erkennung von Anomalien Vantage Cost Alerts überwachen alle verbundenen Anbieter und benachrichtigen Sie per Slack oder E-Mail, wenn die Ausgaben von ihrem üblichen Niveau abweichen. So werden Veränderungen bei den Kosten für Workers oder R2 genauso sichtbar wie bei jedem anderen Anbieter.
• FinOps-Agenten und MCP. Stellen Sie dem integrierten Vantage FinOps Agent beispielsweise die Frage: „Was war in der vergangenen Woche unser größter Kostentreiber über alle Anbieter hinweg?“ Alternativ können Sie dieselben Daten über den gehosteten MCP-Server von Vantage aus Claude oder ChatGPT heraus abfragen. Cloudflare-Kosten werden dabei gemeinsam mit den Kosten Ihrer übrigen verbundenen Anbieter berücksichtigt.

Verbinden Sie Ihr Cloudflare-Konto in der ​Vantage-Konsole. Anschließend werden Ihre Cloudflare-Kosten zusammen mit den Kosten Ihrer übrigen Infrastruktur angezeigt. Manuelle Exporte, Rechnungs-Uploads oder ein separates Dashboard sind nicht erforderlich. 

Diese standardisierte FOCUS-API funktioniert auch mit anderen Fintech-Tools.

Warum wir Billable Usage API entwickelt haben

Agents schreiben nicht nur Code. Sie stellen Workers bereit, provisionieren R2-Buckets und verwalten D1-Datenbanken. Wenn Sie programmgesteuerten Zugriff auf Ihr Cloudflare-Konto gewähren, benötigen Sie ebenso programmgesteuerte Transparenz über die dadurch entstehenden Kosten. Nicht erst am Monatsende, sondern fortlaufend über den Tag hinweg, nach Produkt aufgeschlüsselt und in einem maschinenlesbaren Format, das sich direkt automatisiert verarbeiten lässt.

Genau das bietet die Billable Usage API. Und Kunden wünschen sich seit Jahren einen programmgesteuerten Zugriff auf Nutzungsdaten. Finanzteams möchten Kosten in ihre eigenen Systeme übernehmen und Kosten internen Projekten, Teams oder sogar ihren Endkunden zuordnen. Entwickler möchten einen curl-Befehl, den sie direkt in ein Skript einbauen können. Bisher erforderte jeder dieser Abläufe einen Screenshot oder einen manuellen Export. Heute genügt ein HTTP-Aufruf oder eine Konfiguration in Vantage.

Was kommt als Nächstes?

• Feinere Zeitfenster. Derzeit gibt die API Datenzeilen pro Abrechnungszeitraum zurück, der bei den meisten Produkten einem Tag entspricht. Für Produkte, bei denen es sinnvoll ist, prüfen wir künftig stärker echtzeitnahe Aufschlüsselungen.
• Prognosen. CumulatedContractedCost zeigt Ihnen, wie hoch Ihre bisherigen Ausgaben im aktuellen Abrechnungszeitraum sind. Künftig möchten wir Ihnen dabei helfen, vorherzusagen, wo diese am Ende des Abrechnungszeitraums liegen werden – und zwar nicht nur auf Konto-, sondern auch auf Produktebene.
• Unterstützung für Enterprise-Verträge. Diese erste Version steht ausschließlich für Self-Service-Konten zur Verfügung. Eine vergleichbare Lösung für Enterprise-Verträge ist bereits in Entwicklung.

Probieren Sie es aus

Der Endpunkt ist ab heute für alle Self-Service-Konten verfügbar. Erstellen Sie ein API-Token mit der Berechtigung Billing Read, richten Sie Ihren curl-Aufruf darauf aus, und Sie erhalten eine nach Produkt aufgeschlüsselte Übersicht über den aktuellen Abrechnungszeitraum. Die vollständige Referenz finden Sie in der Cloudflare-API-Dokumentation. Um die Daten gemeinsam mit Ihren übrigen Cloud-Kosten anzuzeigen, verbinden Sie Ihr Cloudflare-Konto in der ​ Vantage-Konsole.

Seit Jahren erleichtert Cloudflare Unternehmen, mehr ihrer Infrastruktur auf unserem Netzwerk auszuführen. Nun machen wir es genauso einfach, die damit verbundenen Kosten zu verstehen – sowohl bei Cloudflare als auch im restlichen Cloud-Stack.