Anthropic 10 月 28 日把 Messages 上限提到 128 MB、10 月 29 日上線 Usage Cost Analytics 之後,帳單 JSON 該讀哪些欄位?

截至 2026 年 10 月 30 日:第一方 Messages/Token Counting 請求體 128 MB;Bedrock 仍約 20 MB。Analytics 需 beta 頭 analytics-usage-cost-2026-08-24,讀 data 列的 group、usage 與 cost.amount,並分頁 next_page。

先給結論:10 月 28 日 Anthropic 把直連 Claude API 上 Messages 與 Token Counting 的單次 HTTP 請求體上限從 32 MB 提到 128 MB;10 月 29 日又公測 Usage and Cost Analytics API,用 JSON 行報表 token 與美元成本。128 MB 只算整包請求(提示、歷史、base64 檔案),不改單張圖片或單頁 PDF 的既有上限。Analytics 每次要帶 anthropic-beta: analytics-usage-cost-2026-08-24,讀 data[] 裡每行的 group、usage 或 cost,並分頁跟 next_page。舊的 Usage and Cost API 與 Enterprise 報表端點改標 legacy,仍可用但有遷移指南。

這篇按 2026 年 10 月 30 日寫,依據 10 月 28–29 日發行說明與 Analytics 檔案。四天前本站寫過《API 版本 2026-10-21 與 temperature 400》。那邊改的是請求欄位合法性;這邊改的是「能塞多大的 JSON 體」以及「帳單 JSON 長什麼樣」。

128 MB 實際覆蓋哪些介面

發行說明寫明:僅第一方 Claude API 的 Messages 與 Token Counting 從 32 MB 提到 128 MB。Message Batches 仍是 256 MB 上限;Files API 仍是 500 MB;Sessions、Agents、Environments 相關請求仍 cap 在 32 MB。漲價的是「單次 POST 裡能帶的對話與嵌入 base64 的 PDF/圖片總量」,不是模型上下文視窗本身。

端點(第一方)原上限10 月 28 日後
Messages / Token Counting32 MB128 MB
Message Batches256 MB256 MB
Files API500 MB500 MB

檔案仍保留單資源限制:例如單張圖片、單份 PDF 頁數或單次請求圖片張數的上限並未因 128 MB 而取消。接近新上限時,應先用 Token Counting 估算,而不是假設「檔案小於 128 MB 就一定能過」。

為什麼 Bedrock 仍是 20 MB

合作伙伴託管平臺各自限流。API 概覽列出的典型值:Amazon Bedrock 約 20 MB;Google Cloud(Google 託管)約 30 MB;Claude Platform on AWS、Anthropic 託管 Google Cloud、Microsoft Foundry 等多為 32 MB。你在第一方測通的多 PDF 批次抽取,部署到 Bedrock 可能仍在舊 ceiling 上 413 或 400。

多環境流水線應在配置裡寫 max_request_bytes 按平臺分支,而不是寫死 128 MB。與《Bedrock 結構化輸出》一樣,功能 parity 不等於傳輸上限 parity。

Analytics API 怎麼請求

Console 與 Enterprise 組織可用 Admin API 金鑰訪問:

  • GET /v1/organizations/analytics/usage — token 與請求次數
  • GET /v1/organizations/analytics/cost — 美元成本(含 list 與折後)

每次請求需要 anthropic-version 與 beta 頭 anthropic-beta: analytics-usage-cost-2026-08-24。查詢參數常用 starting_at、ending_at、time_bucket_width=1d,以及最多五個 group_by[] 維度(如 model、workspace_id、api_key_id)。

響應分頁:has_more、next_page、data_refreshed_at。SDK 讀迭代器時會自動翻頁;手寫 curl 時要迴圈 next_page 直到 has_more 為 false。

usage 行裡幾個 token 欄位怎麼加

每一行有 starting_at、ending_at、group(維度字典)和 usage。沒在 group_by[] 裡宣告的維度在 group 裡是 null,不要當成「零用量」。

{
  "data": [{
    "starting_at": "2026-09-03T00:00:00Z",
    "ending_at": "2026-09-04T00:00:00Z",
    "group": {"model": "claude-sonnet-5", "workspace_id": null},
    "usage": {
      "uncached_input_tokens": 1284500,
      "cache_creation": {
        "ephemeral_5m_input_tokens": 215300,
        "ephemeral_1h_input_tokens": 0
      },
      "cache_read_input_tokens": 3200000,
      "output_tokens": 891000,
      "total_tokens": 5590800,
      "requests": 4210
    }
  }],
  "has_more": true,
  "next_page": "page_...",
  "data_refreshed_at": "2026-09-18T16:02:11Z"
}

對賬時把 cache 寫入拆成 5 分鐘與 1 小時桶,再與 cache read 分開乘價目。若你同時接 OpenAI Responses 的 ttl_30m_tokens / ttl_12h_tokens,欄位名不同,不要混在一個 JSON Schema 裡硬對映。

cost 行裡 amount 怎麼讀

cost 端點每行的 cost.amount 檔案寫的是折後、扣 credit 前的小數美分(fractional cents);list_amount 是折前列表價。貨幣碼目前為 USD。按 cost_type 或 token_type 分組時,requests 可能為 null,檔案說明此時請求次數應從未拆分的彙總行讀取。

落庫建議保留 data_refreshed_at,Analytics 重新整理比 legacy Usage and Cost API 慢,同一小時重複拉取可能仍看到舊快照。BI 層用 data_refreshed_at 做水位線,而不是假設「現在拉就是實時帳單」。

  • JSON 校驗 — 確認分頁合併後的陣列合法。
  • JSONPath — 例如 $.data[*].usage.total_tokens 按 model 彙總。
  • JSON Diff — 對比 legacy 報表與新 Analytics 同一視窗的差異。

legacy 報表還要不要接

10 月 29 日公告把原 Usage and Cost API,以及 Enterprise Analytics 的 usage_report、cost_report、user_usage_report、user_cost_report 標為 legacy,並宣告仍支援。新整合應走 Analytics;舊管道可並行一段時間,用 JSON Diff 驗證同一 starting_at 區間 totals 是否收斂,再切流量。

常見問題 FAQ

128 MB 等於可以把 120 MB 的 PDF base64 一次塞進 messages 嗎?

不一定。整包 HTTP 上限提高到 128 MB,但單 PDF、單圖片、單次請求圖片張數等子限制仍在。還要加上 JSON 結構與 base64 膨脹。先用 Token Counting 驗證。

Message Batches 會跟著變成 128 MB 嗎?

不會。批次介面維持 256 MB 上限,與 Messages 的 128 MB 是兩條線。

Analytics 缺 beta 頭會怎樣?

與未啟用的 beta 能力一樣,請求會失敗或看不到端點。必須帶 analytics-usage-cost-2026-08-24。

group 裡全是 null 是不是沒資料?

不是。null 常表示該維度未出現在 group_by 中,或該行在該維度無值。看 usage 或 cost 數字是否非零。

amount 字串要除以 100 才是美元嗎?

檔案定義 amount 為 fractional cents(小數美分)。換算美元需按檔案示例處理小數,不要當成已經是以美元為單位的浮點字串。

legacy usage_report 會立刻下線嗎?

發行說明寫仍支援,並給出遷移檔案。新功能(更多 group 維度、actor 拆分)只在 Analytics 上擴充套件。

總結

10 月 28–29 日兩件事:更大的第一方請求體,以及更細的帳單 JSON。128 MB 別搬到 Bedrock;Analytics 記得 beta 頭、分頁和 cache 子欄位。legacy 報表可以並存,但新 dashboard 應對齊 Analytics 的行模型。