使用量和成本 API
The Admin API is unavailable for individual accounts. To collaborate with teammates and add members, set up your organization in Console → Settings → Organization.
使用量和成本管理員 API 提供對您組織歷史 API 使用量和成本資料的程式化和細粒度存取。此資料類似於 Claude Console 的使用量和成本頁面中可用的資訊。
此 API 讓您能夠更好地監控、分析和最佳化您的 Claude 實作：
- 準確的使用量追蹤： 取得精確的 token 計數和使用模式，而不是僅依賴回應 token 計數
- 成本對帳： 將內部記錄與 Anthropic 帳單進行匹配，供財務和會計團隊使用
- 產品效能和改進： 監控產品效能，同時測量系統變更是否有所改善，或設定警報
- 速率限制和優先層級最佳化： 最佳化提示快取或特定提示等功能，以充分利用分配的容量，或購買專用容量。
- 進階分析： 執行比 Console 中可用的更深入的資料分析
需要管理員 API 金鑰
此 API 是管理員 API的一部分。這些端點需要管理員 API 金鑰（以 sk-ant-admin... 開頭），與標準 API 金鑰不同。只有具有管理員角色的組織成員才能透過 Claude Console 提供管理員 API 金鑰。
合作夥伴解決方案
領先的可觀測性平台提供現成的整合，用於監控您的 Claude API 使用量和成本，無需編寫自訂程式碼。這些整合提供儀表板、警報和分析，幫助您有效管理 API 使用量。
Datadog
具有自動追蹤和監控的 LLM 可觀測性
Grafana Cloud
無代理整合，提供開箱即用的儀表板和警報，輕鬆實現 LLM 可觀測性
Honeycomb
透過 OpenTelemetry 進行進階查詢和視覺化
快速開始
取得您組織過去 7 天的每日使用量：
curl "https://api.anthropic.com/v1/organizations/usage_report/messages?\
starting_at=2025-01-08T00:00:00Z&\
ending_at=2025-01-15T00:00:00Z&\
bucket_width=1d" \
--header "anthropic-version: 2023-06-01" \
--header "x-api-key: $ADMIN_API_KEY"為整合設定 User-Agent 標頭
如果您正在建立整合，請設定您的 User-Agent 標頭以幫助我們了解使用模式：
User-Agent: YourApp/1.0.0 (https://yourapp.com)使用量 API
使用 /v1/organizations/usage_report/messages 端點追蹤整個組織的 token 消耗，並按模型、工作區和服務層級進行詳細分解。
關鍵概念
- 時間桶： 以固定間隔（
1m、1h或1d）聚合使用量資料 - Token 追蹤： 測量未快取輸入、快取輸入、快取建立和輸出 token
- 篩選和分組： 按 API 金鑰、工作區、模型、服務層級或上下文視窗篩選，並按這些維度分組結果
- 伺服器工具使用量： 追蹤伺服器端工具（如網路搜尋）的使用量
有關完整的參數詳細資訊和回應架構，請參閱使用量 API 參考。
基本範例
按模型的每日使用量
curl "https://api.anthropic.com/v1/organizations/usage_report/messages?\
starting_at=2025-01-01T00:00:00Z&\
ending_at=2025-01-08T00:00:00Z&\
group_by[]=model&\
bucket_width=1d" \
--header "anthropic-version: 2023-06-01" \
--header "x-api-key: $ADMIN_API_KEY"帶篩選的每小時使用量
curl "https://api.anthropic.com/v1/organizations/usage_report/messages?\
starting_at=2025-01-15T00:00:00Z&\
ending_at=2025-01-15T23:59:59Z&\
models[]=claude-sonnet-4-5-20250929&\
service_tiers[]=batch&\
context_window[]=0-200k&\
bucket_width=1h" \
--header "anthropic-version: 2023-06-01" \
--header "x-api-key: $ADMIN_API_KEY"按 API 金鑰和工作區篩選使用量
curl "https://api.anthropic.com/v1/organizations/usage_report/messages?\
starting_at=2025-01-01T00:00:00Z&\
ending_at=2025-01-08T00:00:00Z&\
api_key_ids[]=apikey_01Rj2N8SVvo6BePZj99NhmiT&\
api_key_ids[]=apikey_01ABC123DEF456GHI789JKL&\
workspace_ids[]=wrkspc_01JwQvzr7rXLA5AGx3HKfFUJ&\
workspace_ids[]=wrkspc_01XYZ789ABC123DEF456MNO&\
bucket_width=1d" \
--header "anthropic-version: 2023-06-01" \
--header "x-api-key: $ADMIN_API_KEY"時間粒度限制
| 粒度 | 預設限制 | 最大限制 | 使用案例 |
|---|---|---|---|
1m | 60 個桶 | 1440 個桶 | 即時監控 |
1h | 24 個桶 | 168 個桶 | 每日模式 |
1d | 7 個桶 | 31 個桶 | 每週/每月報告 |
成本 API
使用 /v1/organizations/cost_report 端點檢索以美元為單位的服務級成本分解。
關鍵概念
- 貨幣： 所有成本以美元計算，以最小單位（分）的十進位字串報告
- 成本類型： 追蹤 token 使用量、網路搜尋和程式碼執行成本
- 分組： 按工作區或描述分組成本以進行詳細分解
- 時間桶： 僅每日粒度（
1d）
有關完整的參數詳細資訊和回應架構，請參閱成本 API 參考。
優先層級成本使用不同的計費模式，不包含在成本端點中。請透過使用量端點追蹤優先層級使用量。
基本範例
curl "https://api.anthropic.com/v1/organizations/cost_report?\
starting_at=2025-01-01T00:00:00Z&\
ending_at=2025-01-31T00:00:00Z&\
group_by[]=workspace_id&\
group_by[]=description" \
--header "anthropic-version: 2023-06-01" \
--header "x-api-key: $ADMIN_API_KEY"分頁
兩個端點都支援大型資料集的分頁：
- 發出您的初始請求
- 如果
has_more為true，在下一個請求中使用next_page值 - 繼續直到
has_more為false
# 第一個請求
curl "https://api.anthropic.com/v1/organizations/usage_report/messages?\
starting_at=2025-01-01T00:00:00Z&\
ending_at=2025-01-31T00:00:00Z&\
limit=7" \
--header "anthropic-version: 2023-06-01" \
--header "x-api-key: $ADMIN_API_KEY"
# 回應包含："has_more": true, "next_page": "page_xyz..."
# 帶分頁的下一個請求
curl "https://api.anthropic.com/v1/organizations/usage_report/messages?\
starting_at=2025-01-01T00:00:00Z&\
ending_at=2025-01-31T00:00:00Z&\
limit=7&\
page=page_xyz..." \
--header "anthropic-version: 2023-06-01" \
--header "x-api-key: $ADMIN_API_KEY"常見使用案例
在 anthropic-cookbook 中探索詳細實作：
- 每日使用量報告： 追蹤 token 消耗趨勢
- 成本歸屬： 按工作區分配費用以進行退費
- 快取效率： 測量和最佳化提示快取
- 預算監控： 為支出閾值設定警報
- CSV 匯出： 為財務團隊產生報告
常見問題
資料有多新？
使用量和成本資料通常在 API 請求完成後 5 分鐘內出現，儘管偶爾可能會有更長的延遲。
建議的輪詢頻率是多少？
API 支援每分鐘輪詢一次以持續使用。對於短暫爆發（例如，下載分頁資料），更頻繁的輪詢是可以接受的。為需要頻繁更新的儀表板快取結果。
如何追蹤程式碼執行使用量？
程式碼執行成本出現在成本端點中，在描述欄位中分組為 Code Execution Usage。程式碼執行不包含在使用量端點中。
如何追蹤優先層級使用量？
在使用量端點中按 service_tier 篩選或分組，並尋找 priority 值。優先層級成本在成本端點中不可用。
Workbench 使用量會發生什麼？
來自 Workbench 的 API 使用量不與 API 金鑰關聯，因此即使按該維度分組，api_key_id 也會是 null。
預設工作區如何表示？
歸屬於預設工作區的使用量和成本的 workspace_id 值為 null。
如何取得 Claude Code 的每用戶成本分解？
使用 Claude Code Analytics API，它提供每用戶估計成本和生產力指標，而不會有按許多 API 金鑰分解成本的效能限制。對於具有許多金鑰的一般 API 使用量，請使用使用量 API追蹤 token 消耗作為成本代理。
另請參閱
使用量和成本 API 可用於幫助您為用戶提供更好的體驗、幫助您管理成本並保持您的速率限制。了解更多關於這些其他功能的資訊：
- 管理員 API 概述
- 管理員 API 參考
- 定價
- 提示快取 - 透過快取最佳化成本
- 批次處理 - 批次請求享 50% 折扣
- 速率限制 - 了解使用量層級