Admin API 不適用於個人帳戶。 若要與團隊成員協作並新增成員,請在 Console → Settings → Organization 中設定您的組織。
Usage & Cost Admin API 提供程式化且精細的方式,存取您組織的歷史 API 用量與成本資料。這些資料與 Claude Console 中用量和成本頁面提供的資訊類似。
此 API 讓您能更好地監控、分析和最佳化您的 Claude 實作:
需要 Admin API 金鑰。 這些端點需要 Admin API 金鑰,這與標準的 Claude API 金鑰不同。請參閱建立 Admin API 金鑰,以了解如何為您的組織類型建立金鑰以及應選擇哪些範圍。
Claude Enterprise 組織改用 Analytics API 金鑰搭配不同的 API;請參閱您需要哪個 API?。
AWS 上的 Claude Platform: 程式化的 Usage 和 Cost API 端點目前尚未提供。請改在 Claude Console 的用量和成本頁面檢視用量與成本資料。
Anthropic 透過兩個 API 提供成本和用量報告,取決於您的組織管理哪個 Claude 產品:
| 您的組織 | API | 金鑰類型 |
|---|---|---|
| Claude Console(Claude Platform) | 本頁所述的 Usage and Cost Admin API | Admin API 金鑰(sk-ant-admin01-...) |
| Claude Enterprise(claude.ai) | Claude Enterprise Analytics API 的成本和用量端點 | Analytics API 金鑰 |
Claude Enterprise 母組織不會出現在 Claude Console 中,也沒有 Admin API 金鑰,因此對它們而言,Analytics API 金鑰是取得這些資料的唯一途徑。請參閱 Analytics API 以了解如何建立各種金鑰類型,以及 Claude Enterprise 成本資料適用於哪些方案。
領先的可觀測性平台提供現成可用的整合,讓您無需撰寫自訂程式碼即可監控您的 Claude API 用量與成本。這些整合提供儀表板、警示和分析功能,協助您有效管理 API 用量。
用於追蹤和預測成本的雲端智慧平台
具備自動追蹤和監控功能的 LLM 可觀測性
無代理程式整合,提供開箱即用的儀表板和警示,輕鬆實現 LLM 可觀測性
透過 OpenTelemetry 進行進階查詢和視覺化
用於 LLM 成本與用量可觀測性的 FinOps 平台
取得您組織過去 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" \
-H "anthropic-version: 2023-06-01" \
-H "x-api-key: $ANTHROPIC_ADMIN_KEY"為整合設定 User-Agent 標頭
如果您正在建置整合,請設定您的 User-Agent 標頭,以協助我們了解使用模式:
User-Agent: YourApp/1.0.0 (https://yourapp.com)使用 /v1/organizations/usage_report/messages 端點追蹤整個組織的 token 消耗量,並依模型、工作區和服務層級提供詳細的細分資料。
1m、1h 或 1d)彙總用量資料如需完整的參數詳細資訊和回應結構,請參閱 Usage 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" \
-H "anthropic-version: 2023-06-01" \
-H "x-api-key: $ANTHROPIC_ADMIN_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-opus-5&\
service_tiers[]=batch&\
context_window[]=0-200k&\
bucket_width=1h" \
-H "anthropic-version: 2023-06-01" \
-H "x-api-key: $ANTHROPIC_ADMIN_KEY"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" \
-H "anthropic-version: 2023-06-01" \
-H "x-api-key: $ANTHROPIC_ADMIN_KEY"若要取得您組織的 API 金鑰 ID,請使用 List API Keys 端點。
若要取得您組織的工作區 ID,請使用 List Workspaces 端點,或在 Claude Console 中尋找您組織的工作區 ID。
透過使用 inference_geo 維度對用量進行分組和篩選,來追蹤您的資料落地控制。這對於驗證整個組織的地理路由非常有用。
curl "https://api.anthropic.com/v1/organizations/usage_report/messages?\
starting_at=2026-02-01T00:00:00Z&\
ending_at=2026-02-08T00:00:00Z&\
group_by[]=inference_geo&\
group_by[]=model&\
bucket_width=1d" \
-H "anthropic-version: 2023-06-01" \
-H "x-api-key: $ANTHROPIC_ADMIN_KEY"您也可以篩選特定的地理區域。有效值為 global、us 和 not_available:
curl "https://api.anthropic.com/v1/organizations/usage_report/messages?\
starting_at=2026-02-01T00:00:00Z&\
ending_at=2026-02-08T00:00:00Z&\
inference_geos[]=us&\
group_by[]=model&\
bucket_width=1d" \
-H "anthropic-version: 2023-06-01" \
-H "x-api-key: $ANTHROPIC_ADMIN_KEY"2026 年 2 月之前發布的模型(Claude Opus 4.6 和 Claude Sonnet 4.6 之前)不支援 inference_geo 請求參數,因此其用量報告在此維度會回傳 "not_available"。您可以在 inference_geos[] 中使用 not_available 作為篩選值來鎖定這些模型。
透過使用 speed 維度進行分組和篩選,來追蹤快速模式的用量。這對於監控標準模式與快速模式的用量非常有用。
curl "https://api.anthropic.com/v1/organizations/usage_report/messages?\
starting_at=2026-02-01T00:00:00Z&\
ending_at=2026-02-08T00:00:00Z&\
group_by[]=speed&\
group_by[]=model&\
bucket_width=1d" \
-H "anthropic-version: 2023-06-01" \
-H "anthropic-beta: fast-mode-2026-02-01" \
-H "x-api-key: $ANTHROPIC_ADMIN_KEY"您也可以篩選特定的速度。有效值為 standard 和 fast:
curl "https://api.anthropic.com/v1/organizations/usage_report/messages?\
starting_at=2026-02-01T00:00:00Z&\
ending_at=2026-02-08T00:00:00Z&\
speeds[]=fast&\
group_by[]=model&\
bucket_width=1d" \
-H "anthropic-version: 2023-06-01" \
-H "anthropic-beta: fast-mode-2026-02-01" \
-H "x-api-key: $ANTHROPIC_ADMIN_KEY"speeds[] 篩選器和 speed group_by 值都需要 fast-mode-2026-02-01 beta 標頭。
| 粒度 | 預設限制 | 最大限制 | 使用情境 |
|---|---|---|---|
1m | 60 個區間 | 1,440 個區間 | 即時監控 |
1h | 24 個區間 | 168 個區間 | 每日模式 |
1d | 7 個區間 | 31 個區間 | 每週/每月報告 |
使用 /v1/organizations/cost_report 端點取得以美元計算的服務層級成本細分。
description 分組時,回應會包含已解析的欄位,例如 model 和 inference_geo1d)如需完整的參數詳細資訊和回應結構,請參閱 Cost API 參考文件。
Priority Tier 成本使用不同的計費模式,不包含在成本端點中。請改透過用量端點追蹤 Priority Tier 的使用情況。
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" \
-H "anthropic-version: 2023-06-01" \
-H "x-api-key: $ANTHROPIC_ADMIN_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" \
-H "anthropic-version: 2023-06-01" \
-H "x-api-key: $ANTHROPIC_ADMIN_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..." \
-H "anthropic-version: 2023-06-01" \
-H "x-api-key: $ANTHROPIC_ADMIN_KEY"在 Claude Cookbook 中探索詳細的實作:
用量和成本資料通常在 API 請求完成後 5 分鐘內出現,但偶爾延遲可能會更長。
此 API 支援持續使用時每分鐘輪詢一次。對於短時間的突發需求(例如下載分頁資料),可以接受更頻繁的輪詢。對於需要頻繁更新的儀表板,請快取結果。
程式碼執行成本會出現在成本端點中,在描述欄位中歸類於 Code Execution Usage 之下。程式碼執行不包含在用量端點中。
在用量端點中依 service_tier 進行篩選或分組,並尋找 priority 值。Priority Tier 成本無法在成本端點中取得。
來自 Workbench 的 API 用量不會與 API 金鑰關聯,因此即使依該維度分組,api_key_id 也會是 null。
歸屬於預設工作區的用量和成本,其 workspace_id 值為 null。
請使用 Claude Code Analytics API,它提供每位使用者的估計成本和生產力指標,而不會有依大量 API 金鑰細分成本所帶來的效能限制。對於使用大量金鑰的一般 API 用量,請使用 Usage API 追蹤 token 消耗量作為成本的代理指標。
使用 Usage 和 Cost API 為您的使用者提供更好的體驗、管理成本並維護您的速率限制。進一步了解其他相關功能:
Was this page helpful?