Présentation de l’API Billable Usage : visibilité programmatique des coûts pour Cloudflare

L’Agents Week est dédiée à l’évolution qui est déjà en cours : les agents écrivent du code, déploient des instances Workers et provisionnent l’infrastructure en votre nom. Or, cette évolution modifie ce que vous devez voir. Si un programme entraîne des dépenses sur votre compte Cloudflare, vous devez pouvoir examiner ces dépenses : au fil de la journée, par produit, sous une forme exploitable par un autre programme. Le tableau de bord est la solution idéale pour les humains, mais il n’est pas la solution idéale pour l’automatisation.

C’est pourquoi nous lançons la nouvelle API Billable Usage pour les comptes en libre-service : un point de terminaison unique qui renvoie l’utilisation et le coût de votre compte, répartis par produit et par période de service. Elle couvre tous les produits Cloudflare facturés à l’utilisation associés au compte, notamment Workers, R2, D1, Workers AI, Vectorize, Images et Stream – et tout cela, avec un seul appel. Et si vous utilisez déjà une chaîne d’outils FinOps, les intitulés des colonnes devraient vous sembler familiers.

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"

Vous obtiendrez une réponse HTTP 200 OK avec Content-Type: application/json et les lignes décrivant l’utilisation dans le corps de la réponse. Actuellement, les données relatives à l’utilisation et aux coûts sont mises à jour quotidiennement, pendant que nous nous employons à fournir davantage de données en temps réel.

Ce qui revient

Chaque ligne de la réponse correspond à une période de facturation pour un produit associé à votre compte.

• ServiceName et ServiceFamilyName – le produit (« Workers Standard » sous la famille « Workers », « R2 Storage » sous « R2 », et ainsi de suite).
• ChargePeriodStart / ChargePeriodEnd – la période couverte par cette ligne.
• PricingQuantity et ConsumedUnit – la quantité consommée, exprimée dans l’unité de mesure utilisée pour la facturation (Go-mois, Go-secondes, requêtes, etc.).
• ContractedCost – le coût de cette période, en BillingCurrency.
• CumulatedPricingQuantity et CumulatedContractedCost – les totaux cumulés pour la période de facturation.
• ZoneId / ZoneName – lorsque l’utilisation est attribuée à une zone spécifique.

La plupart de ces intitulés correspondent directement aux colonnes de la spécification ​FinOps Open Cost and Usage (FOCUS). Ainsi, si votre équipe importe déjà des données FOCUS depuis un autre fournisseur, les noms et la sémantique devraient vous paraître familiers :

Les réponses utilisent l’enveloppe standard de l’API Cloudflare : result est un tableau de lignes (à raison d’une ligne par produit et par période de facturation), conjointement à success, errors et 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": []
}

Où en sommes-nous avec FOCUS ?

La conformité aux dénominations FOCUS est un choix délibéré. AWS, Azure, Google Cloud, Oracle et un nombre croissant de fournisseurs de solutions SaaS publient déjà des exportations au format FOCUS, et tous les outils de gestion des coûts dignes de ce nom prennent en charge ce format. Cela dit, nous ne prétendons pas encore proposer une conformité totale : à l’heure actuelle, quelques colonnes requises par la spécification ne sont pas encore incluses dans les données. Leur ajout est prévu dans notre feuille de route. Considérez cela comme une première étape : une forme familière pour l’instant, une conformité totale ensuite.

Vos dépenses dans Cloudflare, intégrées au reste de vos dépenses liées au cloud : notre partenariat avec Vantage

Nous avons établi un partenariat avec ​Vantage pour mettre en place une intégration native avec Cloudflare. Vantage est une plateforme de gestion des coûts d’infrastructure qui collecte les données relatives aux coûts et à l’utilisation auprès de plus de 30 fournisseurs, parmi lesquels des fournisseurs de solutions IA, cloud et SaaS, et les regroupe dans une vue unique à des fins de publication de rapports, d’affectation et d’optimisation. Grâce à cette intégration, vos données d’utilisation sont automatiquement renseignées dans les services Cost Reports, Budgets et Cost Alerts que vous utilisez déjà pour le reste de votre infrastructure.

Vantage se connecte à Cloudflare via un jeton d’API en lecture seule avec l’autorisation d’accès Billing Read. Une fois connecté, Vantage récupère quotidiennement vos données d’utilisation facturable et les répartit par produit (Workers et R2, par exemple), par zone et par compte, vous permettant ainsi d’identifier les produits à l’origine de vos dépenses et de les imputer aux équipes et aux services concernés.

Voici quelques exemples de flux de travail pris en charge par cette intégration :

• Répartition entre fournisseurs. Regroupez les dépenses liées à Cloudflare par produit, par zone et par compte, puis utilisez les balises virtuelles pour les répartir par équipe ou par gamme de produits, parallèlement à vos coûts liés à AWS, Azure et d’autres fournisseurs – et tout cela, dans un rapport unique.
• Détection des anomalies. Le service Vantage Cost Alerts surveille tous les fournisseurs connectés et vous notifie via Slack ou par e-mail lorsque les dépenses s’écartent de leur niveau de référence. Ainsi, toute variation des dépenses liées à Workers ou à R2 est signalée de la même manière que pour n’importe quel autre fournisseur.
• Agents FinOps et MCP. Posez une question à l’agent Vantage FinOps intégré à la console, par exemple : « Quel a été notre principal facteur de coût la semaine dernière, tous fournisseurs confondus ? », ou interrogez Claude ou ChatGPT sur ces mêmes données via le serveur MCP hébergé par Vantage. Les dépenses liées à Cloudflare sont regroupées avec celles de vos autres fournisseurs connectés.

Connectez votre compte Cloudflare dans la ​console Vantage, et vos coûts sont affichés à côté de tous les autres services que vous utilisez. Il n’y a pas d’exportations manuelles, ni de téléchargements de factures, ni de tableau de bord distinct à gérer. 

Cette API normalisée FOCUS est également compatible avec d’autres outils Fintech.

Pourquoi l’avons-nous créée ?

Les agents ne se contentent pas d’écrire du code. Ils déploient des instances Workers, créent des compartiments R2 et gèrent des bases de données D1. Lorsque vous accordez un accès programmatique à votre compte Cloudflare, vous devez bénéficier d’une visibilité programmatique des coûts qu’il entraîne – pas à la fin du mois, mais tout au long de la journée, par produit, sous une forme réellement exploitable par un programme.

L’API Billable Usage incarne cette forme, et cela fait des années que nos clients nous demandent de mettre en œuvre un accès programmatique à ces données. Les équipes financières souhaitent intégrer les dépenses dans leurs propres systèmes et imputer les coûts à leurs différents projets internes, à leurs équipes, et même à leurs clients finaux. Les développeurs, quant à eux, veulent une commande curl qu’ils puissent intégrer directement dans un script. Chacun de ces flux de travail nécessitait auparavant une capture d’écran ou une exportation manuelle. Désormais, il suffit d’un appel HTTP ou d’une configuration dans Vantage.

Les prochaines évolutions

• Fenêtres temporelles plus précises. Actuellement, l’API renvoie des lignes correspondant à la période de facturation, qui est quotidienne pour la plupart des produits. Nous envisageons d’intégrer davantage de répartitions en temps réel pour les produits, si cela s’avère pertinent.
• Prévisions. CumulatedContractedCost vous indique l’état de vos dépenses dans le cycle de facturation en cours. Nous voulons vous aider à anticiper votre situation future – et pas seulement au niveau du compte, mais également au niveau des produits.
• Intégration à l’offre Enterprise. Cette première version est accessible uniquement en libre-service. Une expérience équivalente pour les contrats Enterprise est en cours de développement.Try it

Essayez-le

Le point de terminaison est disponible dès maintenant pour tous les comptes en libre-service. Sélectionnez un jeton d’API avec l’autorisation d’accès Billing Read, renvoyez votre commande curl vers celui-ci et vous obtiendrez votre période de facturation actuelle, répartie par produit. Des informations complètes sont disponibles dans la documentation de l’API Cloudflare. Pour consulter ces informations parallèlement au reste de vos dépenses liées au cloud, connectez votre compte Cloudflare à la ​console Vantage.

Depuis des années, Cloudflare s’engage à vous permettre d’exécuter plus facilement une plus grande partie de votre infrastructure sur notre réseau. Il est temps pour nous de vous permettre de voir tout aussi facilement ce que cela vous coûte – sur Cloudflare, mais également sur toutes les autres plateformes.