Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Usage & Cost Admin API 提供对您组织历史 API 用量和成本数据的编程式细粒度访问。这些数据与 Claude Console 中 Usage（用量）和 Cost（成本）页面上提供的信息类似。
此 API 使您能够更好地监控、分析和优化您的 Claude 实现：
Claude Enterprise 组织使用 Analytics API 密钥和不同的 API；请参阅您需要哪个 API？。
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"通过 /v1/organizations/usage_report/messages 端点跟踪整个组织的令牌消耗，并按模型、工作区和服务层级进行详细细分。
1m、1h 或 1d）聚合用量数据有关完整的参数详情和响应架构，请参阅用量 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"通过使用 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"通过使用 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"| 粒度 | 默认限制 | 最大限制 | 使用场景 |
|---|---|---|---|
1m | 60 个桶 | 1,440 个桶 | 实时监控 |
1h | 24 个桶 | 168 个桶 | 每日模式 |
1d | 7 个桶 | 31 个桶 | 每周/每月报告 |
通过 /v1/organizations/cost_report 端点检索以美元计的服务级别成本明细。
description 分组时，响应包含解析后的字段，如 model 和 inference_geo1d）有关完整的参数详情和响应架构，请参阅成本 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" \
-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 支持持续使用时每分钟轮询一次。对于短时突发（例如下载分页数据），可以接受更频繁的轮询。对于需要频繁更新的仪表板，请缓存结果。
代码执行成本出现在成本端点中，在 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 用量，请使用用量 API 跟踪令牌消耗作为成本代理指标。
使用用量和成本 API 为您的用户提供更好的体验、管理成本并保护您的速率限制。了解有关这些其他功能的更多信息：
Was this page helpful?