Novedad: Billable Usage API, visibilidad programática de los costos en Cloudflare

La Agents Week trata sobre el cambio ya en marcha: los agentes escriben código, implementan Workers y aprovisionan infraestructura en tu nombre. Ese cambio altera lo que necesitas ver. Si un programa está gastando dinero en tu cuenta de Cloudflare, necesitas saber en qué lo está gastando; a lo largo del día, por producto, en un formato que otro programa pueda consumir. El panel de control es la respuesta correcta para los humanos. No es la respuesta correcta para la automatización.

Estamos lanzando una nueva herramienta Billable Usage API para cuentas de autoservicio: un único punto final que devuelve el uso y costo de tu cuenta, desglosado por producto y por período de servicio. Cubre todos los productos de Cloudflare basados en el uso en la cuenta, incluidos Workers, R2, D1, Workers AI, Vectorize, Cloudflare Images y Stream, todo con una sola llamada. Y si ya trabajas en una cadena de herramientas de FinOps, los nombres de las columnas te deberían resultar familiares.

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"

Recibirás un HTTP 200 OK con Content-Type: application/json y las filas de uso en el cuerpo de la respuesta. Hoy, los datos de uso y costos se actualizan diariamente mientras trabajamos para proporcionar datos más en tiempo real.

Lo que regresa

Cada fila en la respuesta representa un periodo de cobro para un producto en tu cuenta.

• ServiceName y ServiceFamilyName: qué producto ("Workers Standard" dentro del grupo "Workers", "R2 Storage" dentro de "R2", etc.).
• ChargePeriodStart / ChargePeriodEnd: el intervalo que cubre esta fila.
• PricingQuantity y ConsumedUnit: cuánto utilizaste, en la unidad de medida que facturamos (meses-GB, segundos-GB, solicitudes, etc.).
• ContractedCost: el costo de ese período, en BillingCurrency.
• CumulatedPricingQuantity y CumulatedContractedCost: totales acumulados para el período de facturación.
• ZoneId / ZoneName: cuando el uso se atribuye a una zona específica.

La mayoría de estos se mapean directamente a columnas en la Especificación Abierta de Costos y Uso de FinOps (FOCUS), por lo que si tu equipo ya ingiere datos FOCUS de otro proveedor, los nombres y la semántica deberían ser familiares:

Las respuestas utilizan la estructura estándar de la API de Cloudflare: result es un arreglo de filas, una por producto por período de cobro, junto con success, errors y 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": []
}

Dónde estamos en FOCUS

La coincidencia de nombres de FOCUS fue una elección deliberada. AWS, Azure, Google Cloud, Oracle y una lista creciente de proveedores de SaaS ya publican exportaciones en formato FOCUS, y todas las herramientas serias de gestión de costos lo reconocen. Dicho esto, aún no afirmamos una conformidad total: una cantidad de columnas que el estándar requiere no están en la carga malintencionada hoy. Llegar allí está en nuestro plan de trabajo. Considera esto el primer paso: forma familiar ahora, plena conformidad después.

El gasto de Cloudflare, junto al resto de tu gasto en la nube: nuestra asociación con Vantage

Nos hemos asociado con Vantage en una integración nativa de Cloudflare. Vantage es una plataforma de gestión de costos de infraestructura que recopila datos de costos y uso de más de 30 proveedores, incluidos AI, la nube y proveedores de SaaS, y los integra en una sola vista para informes, asignación y optimización. Con esta integración, tu uso se integra en los mismos informes de costos, presupuestos y alertas de costos que ya usas para el resto de tu infraestructura.

Vantage se conecta a Cloudflare utilizando un token de API de solo lectura con acceso de lectura de facturación. Una vez conectados, Vantage extrae tus datos de uso facturable diariamente y los desglosa por producto (como Workers y R2), zona y cuenta, para que puedas ver qué productos impulsan tus gastos y atribuirlo a los equipos y servicios detrás de ellos.

Algunos de los flujos de trabajo que admite esta integración:

• Asignación entre proveedores. Agrupa el gasto de Cloudflare por producto, zona y cuenta, y luego usa las etiquetas virtuales para asignar por equipo o línea de producto junto con tus costos de AWS, Azure y otros proveedores, todo en un solo informe.
• Detección de anomalías. Las alertas de costos de Vantage monitorean cada proveedor conectado y te notifican a través de Slack o correo electrónico cuando el gasto se desvía de su línea base, de modo que un cambio en el gasto de Workers o R2 se ve de la misma manera que para cualquier otro proveedor.
• Agentes de FinOps y MCP. Hazle una pregunta al agente Vantage FinOps en el panel, como ser "¿Cuál fue nuestro mayor impulsor de costos la semana pasada en todos los proveedores?" o consultar los mismos datos de Claude o ChatGPT a través del servidor MCP alojado de Vantage. El gasto de Cloudflare se incluye junto con tus otros proveedores conectados.

Conecta tu cuenta de Cloudflare en el panel de Vantage, y tus costos aparecen junto a todo lo demás que ejecutas. No hay exportaciones manuales, cargas de facturas ni panel de control separado que mantener. 

Este API estandarizado de FOCUS también funciona con otras herramientas Fintech.

Por qué desarrollamos esto

Los agentes hacen más que escribir código. Implementan Workers, aprovisionan buckets R2 y gestionan bases de datos D1. Cuando otorgas acceso programático a tu cuenta de Cloudflare, necesitas visibilidad programática de lo que te está costando. No al final del mes, sino a lo largo del día, por producto, en un formato que un programa pueda realmente consumir.

Billable Usage API tiene esa forma. Y los clientes nos han estado pidiendo el uso programático durante años. Los equipos de finanzas quieren integrar los gastos en sus propios sistemas y atribuir costos a proyectos internos, equipos e incluso a sus clientes finales. Los desarrolladores quieren un curl que puedan incluir en un script. Cada uno de esos flujos de trabajo solía implicar una captura de pantalla o una exportación manual. Ahora es una llamada HTTP o una configuración en Vantage.

PRÓXIMOS PASOS

• Ventanas de tiempo de mayor especificidad. Hoy la API devuelve filas de período de carga, que para la mayoría de los productos es diario. Estamos analizando desgloses más en tiempo real para los productos donde tiene sentido.
• Previsiones. CumulatedContractedCost te indica dónde está tu gasto en el ciclo de facturación actual. Queremos ayudarte a predecir dónde terminarás. Y no solo a nivel de cuenta, sino a nivel de producto.
• Cobertura para empresas. Esta primera versión es solo para autoservicio. Se está trabajando en una experiencia equivalente para los contratos Enterprise.

Inténtalo

El punto final está disponible hoy para todas las cuentas de autoservicio. Obtén un token de API con tu permiso de lectura de facturación, dirige tu comando 'curl', y recibirás tu periodo de facturación actual desglosado por producto. La referencia completa está disponible en la documentación de la API de Cloudflare. Para verlo junto con el resto de tus gastos en la nube, conecta tu cuenta de Cloudflare en la consola de Vantage.

Cloudflare ha pasado años facilitando que ejecutes más de tu infraestructura en nuestra red. Es hora de que sea igual de fácil ver cuánto te está costando, en Cloudflare y en todas partes.