管理與監控

使用量與成本 API

透過使用量與成本管理 API，以程式化方式存取您組織的 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 使用量。

CloudZero

用於追蹤和預測成本的雲端智慧平台

Datadog

具有自動追蹤和監控功能的 LLM 可觀測性

Grafana Cloud

無代理整合，提供開箱即用的儀表板和警報，輕鬆實現 LLM 可觀測性

Honeycomb

透過 OpenTelemetry 進行進階查詢和視覺化

Vantage

用於 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: $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-opus-4-6&\
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"

要取得您組織的 API 金鑰 ID，請使用列出 API 金鑰端點。

要取得您組織的工作區 ID，請使用列出工作區端點，或在 Anthropic 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: $ADMIN_API_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: $ADMIN_API_KEY"

2026 年 2 月之前發布的模型（Claude Opus 4.6 之前）不支援 inference_geo 請求參數，因此其使用量報告在此維度上回傳 "not_available"。您可以在 inference_geos[] 中使用 not_available 作為篩選值來定位這些模型。

時間粒度限制

粒度	預設限制	最大限制	使用案例
`1m`	60 個區間	1440 個區間	即時監控
`1h`	24 個區間	168 個區間	每日模式
`1d`	7 個區間	31 個區間	每週/每月報告

成本 API

透過 /v1/organizations/cost_report 端點，取得以美元計價的服務級別成本明細。

關鍵概念

貨幣：所有成本以美元計價，以最小單位（美分）的十進位字串報告
成本類型：追蹤 token 使用量、網頁搜尋和程式碼執行成本
分組：按工作區或描述分組成本以取得詳細明細。按 description 分組時，回應包含解析後的欄位，如 model 和 inference_geo
時間區間：僅支援每日粒度（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"

常見使用案例

在 Claude 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 分析 API，它提供每位使用者的預估成本和生產力指標，而不會有按多個 API 金鑰分解成本的效能限制。對於使用多個金鑰的一般 API 使用量，請使用使用量 API 追蹤 token 消耗量作為成本代理。

另請參閱

使用量和成本 API 可用於幫助您為使用者提供更好的體驗、幫助您管理成本，以及保護您的速率限制。了解更多關於這些其他功能的資訊：

管理 API 概覽
管理 API 參考
定價
提示快取 - 透過快取優化成本
批次處理 - 批次請求享有 50% 折扣
速率限制 - 了解使用層級
資料駐留 - 控制推論地理位置

Was this page helpful?

管理與監控

使用量與成本 API

透過使用量與成本管理 API，以程式化方式存取您組織的 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 讓您能夠更好地監控、分析和優化您的 Claude 實作：

精確的使用量追蹤： 取得精確的 token 計數和使用模式，而非僅依賴回應 token 計數
成本對帳： 為財務和會計團隊將內部記錄與 Anthropic 帳單進行比對
產品效能與改進： 監控產品效能，同時衡量系統變更是否帶來改善，或設定警報
速率限制和優先層級優化： 優化提示快取或特定提示等功能，以充分利用分配的容量，或購買專用容量。
進階分析： 執行比 Console 中更深入的資料分析

需要管理 API 金鑰

合作夥伴解決方案

CloudZero

用於追蹤和預測成本的雲端智慧平台

Datadog

具有自動追蹤和監控功能的 LLM 可觀測性

Grafana Cloud

無代理整合，提供開箱即用的儀表板和警報，輕鬆實現 LLM 可觀測性

Honeycomb

透過 OpenTelemetry 進行進階查詢和視覺化

Vantage

用於 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: $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-opus-4-6&\
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"

要取得您組織的 API 金鑰 ID，請使用列出 API 金鑰端點。

要取得您組織的工作區 ID，請使用列出工作區端點，或在 Anthropic 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: $ADMIN_API_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: $ADMIN_API_KEY"

時間粒度限制

粒度	預設限制	最大限制	使用案例
`1m`	60 個區間	1440 個區間	即時監控
`1h`	24 個區間	168 個區間	每日模式
`1d`	7 個區間	31 個區間	每週/每月報告

成本 API

透過 /v1/organizations/cost_report 端點，取得以美元計價的服務級別成本明細。

關鍵概念

貨幣：所有成本以美元計價，以最小單位（美分）的十進位字串報告
成本類型：追蹤 token 使用量、網頁搜尋和程式碼執行成本
分組：按工作區或描述分組成本以取得詳細明細。按 description 分組時，回應包含解析後的欄位，如 model 和 inference_geo
時間區間：僅支援每日粒度（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"

常見使用案例

在 Claude 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 的每位使用者成本明細？

另請參閱

使用量和成本 API 可用於幫助您為使用者提供更好的體驗、幫助您管理成本，以及保護您的速率限制。了解更多關於這些其他功能的資訊：

管理 API 概覽
管理 API 參考
定價
提示快取 - 透過快取優化成本
批次處理 - 批次請求享有 50% 折扣
速率限制 - 了解使用層級
資料駐留 - 控制推論地理位置

Was this page helpful?