先給結論: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 Counting | 32 MB | 128 MB |
| Message Batches | 256 MB | 256 MB |
| Files API | 500 MB | 500 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 做水位線,而不是假設「現在拉就是實時帳單」。
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 的行模型。