Cloudflare AI Gateway 帳單怎麼看？2026 年 9 月起明細變更

Q: 既有報表還用舊模型名稱，現在要立刻刪掉嗎？

不要直接刪除。先建立舊名稱到新 provider/model 的 mapping，保留生效日期與歷史資料，再讓新月份的報表使用 canonical identifier。

2026-09-02

AI

Cloudflare

/

AI

/

設定管理

/

最佳實踐

/

疑難排解

如果你在 2026 年 9 月看到 Cloudflare AI Gateway 的月度用量帳單，發現不再分開列出 input token、output token 與各自單價，這不是帳單遺漏。Cloudflare 從 9 月 1 日起把前一個月用量的帳單明細改成「每個模型一筆總額」，同時把 invoice 和 logs 裡的模型名稱統一成 provider/model 格式。

這項變更影響的是呈現與對帳入口：財務看到的是模型總額，工程團隊仍應從 AI Gateway logs 或自己的 usage ledger 保留 token、請求、使用者與 gateway 維度。AI Gateway credit purchase invoice 不在這次變更內，不能把兩種發票混成同一份月度用量。

新舊帳單差在哪裡#

Cloudflare 官方範例把原本的兩筆：

舊格式	新格式
`anthropic claude-haiku-4-5-20251001 Input Tokens`：40,000 tokens，$0.04	`anthropic/claude-haiku-4.5`：$0.16
`anthropic claude-haiku-4-5-20251001 Output Tokens`：24,000 tokens，$0.12	同一個模型不再拆成第二筆

新帳單仍然提供模型層級的總成本，但不再直接把 input／output token 數量和單價當成獨立 line items。模型名稱也從供應商特有的版本字串，改成比較一致的 provider/model identifier。這對手動看帳單比較簡單，對原本依賴舊字串做自動分組的報表則可能造成空值或重複分類。

官方公告沒有把這次變更描述成定價或用量計算規則的調整，所以不要只因為 invoice 長相改變，就推論模型變便宜或 token 沒有計算。價格、折扣與 Unified Billing 條件仍要以當期模型與 billing 文件為準。

對帳時把 invoice、logs、credits 分成三層#

建議把月末對帳拆成三份資料，而不是期待一張發票回答所有問題：

資料	適合回答的問題	不要拿它做什麼
月度用量 invoice	這個月每個模型被收了多少總額？	反推每一次請求的 token 明細
AI Gateway logs／analytics	哪個 gateway、模型、時間、使用者或狀態造成用量？	直接當成不可變的財務發票
Credit purchase invoice	何時購買了多少 AI Gateway credits？	當成該月模型 inference 用量

AI Gateway logs 可以保留 prompt／response 以外的請求 metadata，例如 provider、模型、時間、狀態、token usage、cost 與 duration。若不想留存敏感 payload，可以依 logging 設定關閉內容，同時保留成本與除錯需要的 metadata。這樣才能在新帳單不再列 token line item 時，繼續回答「哪個服務用了多少」而不必把 prompt 存下來。

既有報表要先修哪裡#

1. 模型分組改用 canonical identifier#

把報表的 join key 從舊的完整版本字串，改成 logs 與 invoice 共用的 provider/model。例如不要把 anthropic claude-haiku-4-5-20251001 寫死為唯一值，而是讓 anthropic/claude-haiku-4.5 成為新的標準化欄位。

遷移期間可以建立 alias mapping，將舊名稱映射到新名稱；不要直接刪除舊資料，否則跨月份比較時會看不出名稱變更造成的斷點。mapping 也應記錄生效日期，方便日後解釋歷史報表。

2. 不要從 invoice 估算 token 成本#

如果你需要 token、請求數或使用者成本，請在自己的資料庫或 analytics 查詢中保存每日／每小時彙總。月度 invoice 只拿來核對模型總額：

先用 canonical provider/model 對齊 invoice 與 logs。
以同一個帳單月份切出 logs 的 cost total。
對照 gateway、環境與使用者的細項加總。
把 invoice 總額、logs 總額、差異與可能原因留下紀錄。

差異可能來自帳單週期、四捨五入、退款、折扣或資料延遲。沒有官方明確說明時，不要把差額直接歸因於 token 漏算；先確認時間範圍與 billing source。

3. 把 credits 的現金流另外核對#

Unified Billing 是 Cloudflare AI Gateway 的 credits 付款路徑。購買 credits 的發票與模型用量 invoice 的用途不同；前者適合核對儲值、付款與 5% credits fee，後者適合核對模型使用總額。既有的 Workers AI 統一計費設定已整理 binding、gateway 和憑證優先順序，這篇只補上月度 invoice 的對帳影響。

如果團隊還需要在發票前就抓到異常支出，可以在 gateway 層使用 spend limits，或搭配 AI Gateway User Insights 與 Access 識別做使用者歸因；這些是日常控管，不是用來替代月度發票。

一個不依賴舊帳單欄位的對帳格式#

可以在自己的 usage ledger 保留以下欄位：

1
usage_month, provider, model, gateway_id, environment,
2
request_count, input_tokens, output_tokens, cache_read_tokens,
3
reported_cost, source_updated_at

其中 reported_cost 應標註是 logs、analytics 還是 invoice 的數值，避免同一欄被不同來源覆寫。model 使用當時 logs 的 canonical identifier；若上游再次改名，另加 mapping 記錄，不要回頭改寫歷史請求。

對小團隊而言，不需要一開始就建完整財務系統。每天匯出 gateway 的成本與用量彙總、每月收到 invoice 後做一次模型總額核對，就比只保留一張 PDF 發票更能解釋異常。

結論：新帳單適合看總額，細節要由日誌自己保留#

Cloudflare AI Gateway 2026 年 9 月的新 invoice 格式，將月度用量收斂成每個模型一筆總額，並統一 provider/model 名稱；AI Gateway credit purchase invoice 不受這項變更影響。實務上應把 invoice 當成模型層級的財務總額，把 logs／analytics 當成 token 與責任歸屬來源，兩者用 canonical model identifier 對齊。