API sử dụng tính phí của Cloudflare: Minh bạch chi phí theo chương trình cho Agent

Tuần lễ Agent của Cloudflare khởi động với trọng tâm về sự chuyển dịch nơi agent viết mã, triển khai Worker và cung cấp hạ tầng. Sự chuyển dịch đó đòi hỏi một loại minh bạch mới: nếu một chương trình đang tiêu tiền trong tài khoản của bạn, bạn cần biết nó đang chi gì, suốt cả ngày, theo từng sản phẩm, ở định dạng mà một chương trình khác có thể tiêu thụ. Bảng điều khiển dành cho con người; API sử dụng tính phí dành cho tự động hóa.

Endpoint mới, có sẵn cho tài khoản tự phục vụ, trả về mức sử dụng và chi phí được phân theo sản phẩm và kỳ dịch vụ. Một lệnh gọi bao phủ tất cả sản phẩm dựa trên mức sử dụng: Worker, R2, D1, Workers AI, Vectorize, Images và Stream. Phản hồi sử dụng khung API chuẩn của Cloudflare, với mỗi hàng đại diện cho một kỳ tính phí cho một sản phẩm.

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

Bạn cũng có thể chỉ định phạm vi ngày:

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"

Mỗi hàng bao gồm các trường như ServiceName, ServiceFamilyName, ChargePeriodStart/ChargePeriodEnd, PricingQuantity, ConsumedUnit, ContractedCost và tổng lũy kế. Hầu hết ánh xạ trực tiếp đến Thông số Chi phí và Sử dụng Mở FinOps (FOCUS), giúp dễ dàng tích hợp với các chuỗi công cụ FinOps hiện có.

Cloudflare chưa tuyên bố tuân thủ đầy đủ FOCUS—một vài cột bắt buộc còn thiếu, nhưng điều đó nằm trong lộ trình. Đây là bước đầu tiên: định dạng quen thuộc ngay bây giờ, tuân thủ đầy đủ tiếp theo.

Cùng với API, Cloudflare hợp tác với Vantage, một nền tảng quản lý chi phí, để cung cấp tích hợp gốc. Vantage thu thập dữ liệu từ hơn 30 nhà cung cấp, và với tích hợp này, chi tiêu Cloudflare xuất hiện trong cùng Báo cáo Chi phí, Ngân sách và Cảnh báo Chi phí. Bạn có thể phân bổ chi tiêu theo sản phẩm, vùng và tài khoản, phát hiện bất thường qua Slack hoặc email, và thậm chí truy vấn dữ liệu qua agent FinOps hoặc máy chủ MCP.

Tại sao xây dựng điều này? Agent không chỉ viết mã—chúng triển khai Worker, cấp phát bucket R2 và quản lý cơ sở dữ liệu D1. Khi bạn cấp quyền truy cập theo chương trình, bạn cần minh bạch theo chương trình. Nhóm tài chính muốn kéo chi tiêu vào hệ thống nội bộ; nhà phát triển muốn một lệnh curl họ có thể viết kịch bản. API này biến điều đó thành một lệnh gọi HTTP.

Tiếp theo là gì: cửa sổ thời gian chi tiết hơn (dữ liệu gần thời gian thực hơn), dự báo dựa trên chi phí lũy kế và phạm vi hợp đồng doanh nghiệp. Hiện tại, tài khoản tự phục vụ có thể bắt đầu sử dụng endpoint ngay lập tức với token Đọc Thanh toán.