API de facturación Cloudflare: costos por API
En pocas palabras: Cloudflare lanzó el 3 de agosto de 2026 la Billable Usage API, un endpoint REST (GET /accounts/$ACCOUNT_ID/billable-usage) que devuelve uso y costo facturable de toda la cuenta desglosado por producto (Workers, R2, D1, Workers AI) siguiendo el estándar FOCUS de FinOps. Disponible para cuentas self-serve, actualiza datos a diario.
Cloudflare lanzó el 3 de agosto de 2026 la Billable Usage API, un endpoint único que devuelve el uso y el costo de tu cuenta desglosado por producto y por período. La API de facturación de Cloudflare cubre Workers, R2, D1, Workers AI y varios productos más en una sola llamada, con datos que se refrescan una vez por día. Es para cuentas self-serve; Enterprise todavía está en camino.
La Billable Usage API es un endpoint REST de Cloudflare que devuelve, en una sola consulta autenticada por token, el consumo y el costo facturable de una cuenta self-serve, desglosado por producto y por período de servicio. Sigue el estándar FOCUS de FinOps, cubre productos como Workers, R2, D1, Workers AI, Vectorize, Images y Stream, y actualiza los datos a diario según el anuncio oficial de Cloudflare.
En 30 segundos
- Un solo endpoint devuelve uso y costo de toda la cuenta:
GET /accounts/$ACCOUNT_ID/billable-usage. - Cubre todos los productos usage-based en una llamada: Workers, R2, D1, Workers AI, Vectorize, Images y Stream.
- Datos diarios, no en tiempo real (todavía). Cloudflare dice que va hacia data más real-time.
- Sigue el estándar FOCUS, así que los nombres de columnas te van a resultar familiares si ya usás una herramienta de FinOps.
- Solo self-serve por ahora. Si estás en Enterprise, esperá.
Cloudflare es una plataforma de infraestructura web que proporciona servicios de CDN, DNS, protección DDoS y certificados SSL/TLS. Es desarrollada por Cloudflare Inc., fundada en 2009.
¿Por qué Cloudflare lanzó esto durante la Agents Week?
Porque los agentes ya están gastando plata en tu cuenta. Cloudflare enmarcó el lanzamiento dentro de su “Agents Week”, y el argumento es directo: hoy hay programas que escriben código, despliegan Workers y provisionan infraestructura por vos. Si un proceso automático gasta, necesitás verlo de forma automática.
El dashboard es la respuesta correcta para un humano que quiere mirar un gráfico y tomar una decisión. No es la respuesta correcta para un script que corre cada noche y tiene que atribuir costos a un proyecto. Ese es el hueco que tapa esta API. Ponele que tenés un agente desplegando Workers a las 3 de la mañana: al otro día querés saber cuánto salió eso sin que nadie abra el panel a mano. Tema relacionado: gestión segura de variables en Workers.
¿Cómo funciona técnicamente la API de facturación de Cloudflare?
Es una llamada GET autenticada con un token Bearer. Apuntás al endpoint de tu cuenta, opcionalmente le pasás un rango de fechas con from y to, y te devuelve un JSON con una fila por cada cargo, por cada producto, por cada período de servicio. Nada de OAuth complicado ni webhooks: pedís y leés.
La estructura mínima del request es así:
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" \
-H "Content-Type: application/json"Cada fila de la respuesta es un período de cargo para un producto. Trae el nombre del producto y su familia (por ejemplo “Workers Standard” dentro de la familia “Workers”, o “R2 Storage” dentro de “R2”), la ventana de tiempo que cubre esa fila, y la cantidad consumida en su unidad de medida junto al costo acumulado. Un detalle importante: según la documentación de Cloudflare, hoy el uso y el costo se actualizan a diario mientras trabajan hacia datos más cercanos al tiempo real. O sea: no lo uses para alertas al segundo, porque no es eso.
¿Qué productos puedo monitorear con la API?
Todos los productos usage-based de la cuenta, en una sola llamada. Cloudflare confirmó que la respuesta incluye Workers, R2, D1, Workers AI, Vectorize, Images y Stream. Cada uno reporta su métrica propia: Workers mide requests, R2 separa almacenamiento de operaciones Clase A y Clase B, D1 cuenta filas leídas y escritas, y así.
| Producto | Familia | Qué se mide (unidad) |
|---|---|---|
| Workers Standard | Workers | Requests y tiempo de CPU |
| R2 Storage | R2 | GB-mes almacenados |
| R2 Class A / Class B Ops | R2 | Operaciones (escritura / lectura) |
| D1 | D1 | Filas leídas y escritas |
| Workers AI | Workers AI | Neurons / unidades de inferencia |
| Vectorize | Vectorize | Consultas y vectores almacenados |
| Images | Images | Imágenes servidas y almacenadas |
| Stream | Stream | Minutos entregados y almacenados |
¿Cuál es la diferencia entre el dashboard y la API de costos?
El dashboard es para mirar; la API es para automatizar. En el panel vos entrás, ves un gráfico, comparás dos meses y decidís. Con la API un programa hace lo mismo sin manos: sincroniza los costos cada día, los guarda en tu base y los atribuye a un equipo o a un cliente. Lo explicamos a fondo en infraestructura DNS que impacta en costos.
¿Cuándo la API deja de ser un lujo y pasa a ser obligatoria? Cuando tenés billing multi-tenant y necesitás cobrarle a cada cliente lo que consumió. Cuando querés una auditoría automática que corra sin que nadie la dispare. Cuando armás alertas dinámicas que se recalculan solas. Para todo eso, abrir el dashboard a mano no escala.
¿Cómo consultar costos de una zona o proyecto específico?
Filtrás por zona usando los campos de identificación de zona que trae cada fila. Con eso podés armar un script que sume el costo de un dominio puntual y lo impute al equipo que lo maneja. Un ejemplo concreto: un script en Python que pega a la API cada mañana, filtra las filas de la zona ejemplo.com, suma el costo del día y lo escribe en una planilla. Si corrés varios sitios sobre tu propia infraestructura de hosting en donweb.com más servicios de Cloudflare por encima, esa atribución por zona es lo que te ordena la factura interna.
¿Cómo integrar la API en herramientas de FinOps?
La vía más directa es que los nombres de columnas ya siguen el estándar FOCUS, la especificación abierta de FinOps para costos y uso. Eso significa que tu herramienta de cost management no necesita un mapeo raro: las columnas se parecen a las de otros proveedores. Cloudflare mencionó a Vantage como integración nativa para ver tus costos de Cloudflare junto al resto de tu infraestructura.
El flujo típico es simple. Configurás un job diario que llama a la API, normaliza las filas y las empuja a tu dashboard, a una spreadsheet o al sistema de FinOps que ya uses. Como el dato es diario, no hace falta polling agresivo: una corrida por día alcanza y sobra. Lo interesante del enfoque FOCUS es que después podés poner los costos de Cloudflare al lado de los de otros proveedores sin traducir formatos a mano. Más contexto en comparativa de precios con alternativas de AWS.
Qué está confirmado y qué no
- Confirmado: el endpoint
/accounts/{id}/billable-usage, la autenticación por token Bearer y los parámetrosfrom/to. - Confirmado: cobertura de Workers, R2, D1, Workers AI, Vectorize, Images y Stream en una sola llamada.
- Confirmado: actualización diaria de los datos y compatibilidad con el estándar FOCUS.
- Confirmado: disponibilidad para cuentas self-serve desde el 3 de agosto de 2026.
- Pendiente: soporte para cuentas Enterprise, que Cloudflare dice tener en desarrollo.
- Pendiente: datos en tiempo real. Hoy hay un rezago de hasta un día.
Errores comunes al usar la API
La mayoría de los tropiezos no son bugs de Cloudflare, son supuestos equivocados. Estos son los que más se repiten:
- Asumir que los datos son en tiempo real. No lo son. Si armás una alerta esperando ver el gasto de hace cinco minutos, te vas a comer un delay de hasta 24 horas. Diseñá pensando en un ciclo diario.
- Usar un token sin los permisos correctos. Si el token no tiene scope de facturación sobre la cuenta, la respuesta falla. Revisá los permisos antes de culpar al endpoint.
- Probarlo en una cuenta Enterprise. Todavía no está disponible ahí. Vas a pegarle a la pared y no es un error tuyo, es que no llegó a ese plan.
- Mandar mal el rango de fechas. Si invertís
fromytoo pedís un rango vacío, la respuesta viene sin filas y pensás que no hay consumo cuando en realidad la query estaba mal armada.
Preguntas Frecuentes
¿Qué es la Billable Usage API de Cloudflare?
Es un endpoint REST que devuelve el uso y el costo facturable de una cuenta Cloudflare, desglosado por producto y por período de servicio, en una sola llamada. Cubre todos los productos usage-based de la cuenta y sigue el estándar FOCUS de FinOps.
¿Cuándo se lanzó?
Cloudflare la anunció el 3 de agosto de 2026, dentro de su “Agents Week”. Está disponible desde ese día para cuentas self-serve; el soporte para Enterprise sigue en desarrollo. En almacenamiento sin cargo de egreso profundizamos sobre esto.
¿Cómo consulto los costos sin entrar al dashboard?
Hacés un GET al endpoint /accounts/$ACCOUNT_ID/billable-usage con un token Bearer en el header de autorización. Podés acotar el resultado con los parámetros from y to. La respuesta es un JSON con una fila por producto y período.
¿Los datos son en tiempo real?
No. Hoy el uso y el costo se actualizan una vez por día. Cloudflare dijo que trabaja hacia datos más cercanos al tiempo real, pero por ahora hay un rezago de hasta 24 horas.
¿Sirve para atribuir costos a clientes o equipos?
Sí. Cada fila trae la identificación de zona, así que podés filtrar por dominio y sumar el costo por proyecto, equipo o cliente final. Es justo el caso de uso para billing multi-tenant o auditoría interna automatizada.
Conclusión
Lo que cambió es concreto: antes, ver cuánto gastabas en Cloudflare por producto exigía abrir el dashboard y mirar con ojos humanos. Ahora un programa lo hace solo, con un GET y un token. Si tenés agentes o scripts desplegando infraestructura, esta API es la pieza que te faltaba para no descubrir la factura a fin de mes.
¿Qué conviene hacer ahora? Si estás en self-serve, armá un job diario que sincronice los costos por zona y los mande a tu herramienta de FinOps. Como sigue FOCUS, la integración es liviana. Eso sí: no la trates como real-time y verificá que tu token tenga los permisos de facturación. Para Enterprise, todavía toca esperar.
