使用量與費用 API

管理監控

使用量和成本 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 實作：

準確的使用量追蹤： 獲得精確的代幣計數和使用量模式，而不是僅依賴回應代幣計數
成本對帳： 將內部記錄與 Anthropic 帳單相匹配，供財務和會計團隊使用
產品效能和改進： 監控產品效能，同時測量對系統的變更是否改進了它，或設定警報
速率限制和優先級層級最佳化： 最佳化功能，例如提示快取或特定提示，以充分利用您分配的容量，或購買專用容量。
進階分析： 執行比 Console 中可用的更深入的資料分析

需要管理 API 金鑰

此 API 是管理 API 的一部分。這些端點需要管理 API 金鑰（以 sk-ant-admin... 開頭），與標準 API 金鑰不同。只有具有管理員角色的組織成員才能透過 Claude Console 佈建管理 API 金鑰。

合作夥伴解決方案

領先的可觀測性平台提供現成的整合，用於監控您的 Claude API 使用量和成本，無需編寫自訂程式碼。這些整合提供儀表板、警報和分析，幫助您有效管理 API 使用量。

CloudZero

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

快速開始

取得您組織過去 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 端點追蹤整個組織的代幣消耗，並按模型、工作區和服務層級進行詳細分解。

關鍵概念

時間桶： 在固定間隔（1m、1h 或 1d）中聚合使用量資料
代幣追蹤： 測量未快取輸入、快取輸入、快取建立和輸出代幣
篩選和分組： 按 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-7&\
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 作為篩選值來定位這些模型。

快速模式（測試版：研究預覽）

透過使用 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: $ADMIN_API_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: $ADMIN_API_KEY"

speeds[] 篩選和 speed group_by 值都需要 fast-mode-2026-02-01 測試版標頭。

時間粒度限制

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

成本 API

使用 /v1/organizations/cost_report 端點以美元檢索服務級別成本分解。

關鍵概念

貨幣： 所有成本以美元計，報告為最低單位（美分）的十進位字串
成本類型： 追蹤代幣使用量、網路搜尋和程式碼執行成本
分組： 按工作區或描述分組成本以進行詳細分解。按 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 中探索詳細的實作：

每日使用量報告： 追蹤代幣消耗趨勢
成本歸屬： 按工作區分配費用以進行費用分攤
快取效率： 測量和最佳化提示快取
預算監控： 為支出閾值設定警報
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 來追蹤代幣消耗作為成本代理。

另請參閱

使用量和成本 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 實作：

準確的使用量追蹤： 獲得精確的代幣計數和使用量模式，而不是僅依賴回應代幣計數
成本對帳： 將內部記錄與 Anthropic 帳單相匹配，供財務和會計團隊使用
產品效能和改進： 監控產品效能，同時測量對系統的變更是否改進了它，或設定警報
速率限制和優先級層級最佳化： 最佳化功能，例如提示快取或特定提示，以充分利用您分配的容量，或購買專用容量。
進階分析： 執行比 Console 中可用的更深入的資料分析

需要管理 API 金鑰

合作夥伴解決方案

CloudZero

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

快速開始

取得您組織過去 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 端點追蹤整個組織的代幣消耗，並按模型、工作區和服務層級進行詳細分解。

關鍵概念

時間桶： 在固定間隔（1m、1h 或 1d）中聚合使用量資料
代幣追蹤： 測量未快取輸入、快取輸入、快取建立和輸出代幣
篩選和分組： 按 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-7&\
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"

快速模式（測試版：研究預覽）

透過使用 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: $ADMIN_API_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: $ADMIN_API_KEY"

speeds[] 篩選和 speed group_by 值都需要 fast-mode-2026-02-01 測試版標頭。

時間粒度限制

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

成本 API

使用 /v1/organizations/cost_report 端點以美元檢索服務級別成本分解。

關鍵概念

貨幣： 所有成本以美元計，報告為最低單位（美分）的十進位字串
成本類型： 追蹤代幣使用量、網路搜尋和程式碼執行成本
分組： 按工作區或描述分組成本以進行詳細分解。按 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 中探索詳細的實作：

每日使用量報告： 追蹤代幣消耗趨勢
成本歸屬： 按工作區分配費用以進行費用分攤
快取效率： 測量和最佳化提示快取
預算監控： 為支出閾值設定警報
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?