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

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

Así que vamos a lanzar una nueva Billable Usage API para cuentas de autoservicio: un único punto de acceso que te muestra el uso y el coste de tu cuenta, desglosados por producto y por periodo de servicio. Abarca todos los productos de Cloudflare basados en el uso que tengas en la cuenta, como Workers, R2, D1, Workers AI, Vectorize, Images y Stream, todo con una sola llamada. Y si ya trabajas con una cadena de herramientas de operaciones financieras, los nombres de las columnas te resultarán 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 código de estado HTTP 200 OK con Content-Type: application/json y las filas de uso en el cuerpo de la respuesta. Actualmente, los datos de uso y coste se actualizan a diario, aunque seguimos trabajando para ofrecer más datos en tiempo real.

¿Qué resultados se obtienen?

Cada fila de la respuesta corresponde a un periodo de facturación de un producto de tu cuenta.

• ServiceName y ServiceFamilyName — qué producto ("Workers Standard" dentro de la familia "Workers", "almacenamiento R2" dentro de "R2", etc.).
• ChargePeriodStart / ChargePeriodEnd — el intervalo de tiempo que abarca esta fila.
• PricingQuantity y ConsumedUnit — cuánto has usado, en la unidad de medida con la que facturamos (GB-meses, GB-segundos, solicitudes, etc.).
• ContractedCost — lo que costó ese periodo, en BillingCurrency.
• CumulatedPricingQuantity y CumulatedContractedCost — totales acumulados para el periodo de facturación.
• ZoneId / ZoneName — cuando el uso se atribuye a una zona específica.

La mayoría se corresponden directamente con las columnas de la Especificación Abierta de Costes y Uso de Operaciones Financieras (FOCUS), por lo que si tu equipo ya está incorporando datos de FOCUS de otro proveedor, los nombres y la semántica deberían resultar familiares:

Las respuestas utilizan la estructura estándar de la API de Cloudflare: el resultado es una matriz de filas, una por producto y por periodo de facturación, junto con información sobre el éxito, los errores y los mensajes.

{
  "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": []
}

En qué punto estamos con FOCUS

La coincidencia con el nombre de FOCUS fue una elección deliberada. AWS, Azure, Google Cloud, Oracle y una lista cada vez mayor de proveedores de SaaS ya publican exportaciones con el formato FOCUS, y todas las herramientas serias de gestión de costes son compatibles con él. Dicho esto, por ahora aún no cumplimos al 100 % con el estándar FOCUS: algunos de los campos obligatorios todavía no aparecen en la respuesta. Llegar a ese punto forma parte de nuestra hoja de ruta. Tómatelo como un primer paso: ahora ya tienes una idea general, y lo siguiente será el cumplimiento total.

El gasto en Cloudflare, junto con el resto de tu gasto en la nube | Nuestra colaboración con Vantage

Nos hemos asociado con Vantage en una integración nativa de Cloudflare. Vantage es una plataforma de gestión de costes de infraestructura que recopila datos de costes y uso de más de 30 proveedores — entre los que se incluyen proveedores de IA, de nube y de SaaS — y los reúne en una única vista para la elaboración de informes, asignación y optimización. Con esta integración, tu uso se incluye en los mismos informes de costes, presupuestos y alertas de costes que ya utilizas para el resto de tu infraestructura.

Vantage se conecta a Cloudflare mediante un token de API de solo lectura con acceso de lectura a la facturación. Una vez conectado, Vantage extrae a diario tus datos de Billable Usage y los desglosa por producto (como Workers y R2), zona y cuenta, para que puedas ver qué productos generan más gasto y asignarlo a los equipos y servicios responsables.

Estos son algunos de los flujos de trabajo que admite esta integración:

• Asignación entre proveedores. Analiza el gasto de Cloudflare por producto, zona y cuenta, y luego usa las etiquetas virtuales para desglosarlo por equipo o línea de productos junto con los costes de AWS, Azure y otros proveedores, todo en un único informe.
• Detección de anomalías. Las alertas de costes de Vantage supervisan todos los proveedores conectados y te avisan por Slack o correo electrónico cuando el gasto se desvía de su nivel de referencia, de modo que cualquier cambio en el gasto de Workers o R2 se detecta igual que con cualquier otro proveedor.
• Agentes de operaciones financieras y Protocolo de Contexto de Modelo (MCP). Hazle una pregunta al agente de operaciones financieras de la consola de Vantage, como por ejemplo: "¿Cuál fue nuestro mayor factor de coste la semana pasada entre todos los proveedores?", o consulta 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 la consola de Vantage, y tus costes aparecen junto a todo lo demás que ejecutas. No hay que hacer exportaciones manuales, ni subir facturas, ni mantener un panel de control aparte. 

Esta API estandarizada de FOCUS también funciona con otras herramientas de tecnología financiera.

Por qué lo hemos desarrollado

Los agentes hacen más que escribir código. Implementan Workers, aprovisionan buckets de R2 y gestionan bases de datos de D1. Cuando concedes acceso programático a tu cuenta de Cloudflare, necesitas saber exactamente cuánto 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 procesar.

Billable Usage API es justo lo que necesitas. Y los clientes llevan años pidiéndonos el uso programático. Los equipos financieros quieren incorporar los gastos a sus propios sistemas y asignar los costes a proyectos internos, equipos e incluso a sus clientes finales. Los desarrolladores quieren un comando `curl que puedan meter directamente en un script. Antes, cada uno de esos procesos requería una captura de pantalla o una exportación manual. Ahora basta con una llamada HTTP o una configuración en Vantage.

¿Y ahora qué?

• Intervalos de tiempo más precisos. Hoy en día, la API devuelve filas por periodo de facturación, que para la mayoría de los productos es diario. Estamos considerando desgloses en tiempo real más detallados para los productos donde tenga sentido.
• Previsiones. CumulatedContractedCost te indica en qué punto del ciclo de facturación actual te encuentras en cuanto al gasto. Queremos ayudarte a predecir cuál será el resultado final. Y no solo a nivel de cuenta, sino también a nivel de producto.
• Cobertura para empresas. Esta primera versión es solo de autoservicio. Estamos trabajando en una experiencia equivalente para los contratos Enterprise.

Pruébalo

El punto final está activo hoy para todas las cuentas de autoservicio. Consigue un token de API con permiso de lectura de facturación, dirige tu comando `curl` hacia él y obtendrá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 al resto de tu gasto en la nube, conecta tu cuenta de Cloudflare en la consola Vantage.

Cloudflare lleva años trabajando para que te resulte más fácil ejecutar una mayor parte de tu pila en nuestra red. Ya es hora de que te pongamos igual de fácil ver cuánto te está costando todo esto, tanto en Cloudflare como en cualquier otro sitio.