Admin API 不適用於個人帳戶。 若要與團隊成員協作並新增成員,請在 Console → Settings → Organization 中設定您的組織。
Usage & Cost Admin API 提供程式化且細緻的方式,讓您存取組織的歷史 API 用量與成本資料。這些資料與 Claude Console 中 Usage(用量)和 Cost(成本)頁面所提供的資訊類似。
此 API 可協助您更有效地監控、分析及最佳化您的 Claude 實作:
需要 Admin API 金鑰。 這些端點需要 Admin API 金鑰,這與標準的 Claude API 金鑰不同。請參閱建立 Admin API 金鑰,以了解如何為您的組織類型建立金鑰以及應選擇哪些範圍。
Claude Enterprise 組織使用 Analytics API 金鑰搭配不同的 API;請參閱您需要哪個 API?。
AWS 上的 Claude Platform: 目前尚未提供程式化的 Usage 與 Cost API 端點。請改為在 Claude Console 的 Usage 和 Cost 頁面中檢視用量與成本資料。
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" \
--header "anthropic-version: 2023-06-01" \
--header "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" \
--header "anthropic-version: 2023-06-01" \
--header "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-4-8&\
service_tiers[]=batch&\
context_window[]=0-200k&\
bucket_width=1h" \
--header "anthropic-version: 2023-06-01" \
--header "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" \
--header "anthropic-version: 2023-06-01" \
--header "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" \
--header "anthropic-version: 2023-06-01" \
--header "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" \
--header "anthropic-version: 2023-06-01" \
--header "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" \
--header "anthropic-version: 2023-06-01" \
--header "anthropic-beta: fast-mode-2026-02-01" \
--header "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" \
--header "anthropic-version: 2023-06-01" \
--header "anthropic-beta: fast-mode-2026-02-01" \
--header "x-api-key: $ANTHROPIC_ADMIN_KEY"speeds[] 篩選器與 speed group_by 值都需要 fast-mode-2026-02-01 測試版標頭。
| 粒度 | 預設限制 | 最大限制 | 使用情境 |
|---|---|---|---|
1m | 60 個區間 | 1440 個區間 | 即時監控 |
1h | 24 個區間 | 168 個區間 | 每日模式 |
1d | 7 個區間 | 31 個區間 | 每週/每月報告 |
透過 /v1/organizations/cost_report 端點,擷取以美元計價的服務層級成本明細。
description 分組時,回應會包含如 model 和 inference_geo 等已解析的欄位1d)如需完整的參數詳情與回應結構描述,請參閱 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" \
--header "anthropic-version: 2023-06-01" \
--header "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" \
--header "anthropic-version: 2023-06-01" \
--header "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..." \
--header "anthropic-version: 2023-06-01" \
--header "x-api-key: $ANTHROPIC_ADMIN_KEY"在 Claude Cookbook 中探索詳細的實作範例:
用量與成本資料通常會在 API 請求完成後 5 分鐘內出現,但偶爾可能會有較長的延遲。
此 API 支援持續使用時每分鐘輪詢一次。對於短時間的突發需求(例如下載分頁資料),可接受更頻繁的輪詢。對於需要頻繁更新的儀表板,請快取結果。
程式碼執行成本會出現在成本端點中,在 description 欄位下歸類為 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?