Loading...
    • 开发者指南
    • API 参考
    • MCP
    • 资源
    • 更新日志
    Search...
    ⌘K
    入门
    Claude 简介快速开始
    模型与定价
    模型概览选择模型Claude 4.6 新特性迁移指南模型弃用定价
    使用 Claude 构建
    功能概览使用 Messages API处理停止原因提示词最佳实践
    上下文管理
    上下文窗口压缩上下文编辑
    能力
    提示缓存扩展思考自适应思考推理力度流式消息批量处理引用多语言支持Token 计数嵌入视觉PDF 支持Files API搜索结果结构化输出
    工具
    概览如何实现工具使用细粒度工具流式传输Bash 工具代码执行工具程序化工具调用计算机使用工具文本编辑器工具网页抓取工具网页搜索工具记忆工具工具搜索工具
    Agent Skills
    概览快速开始最佳实践企业级 Skills通过 API 使用 Skills
    Agent SDK
    概览快速开始TypeScript SDKTypeScript V2（预览版）Python SDK迁移指南
    API 中的 MCP
    MCP 连接器远程 MCP 服务器
    第三方平台上的 Claude
    Amazon BedrockMicrosoft FoundryVertex AI
    提示工程
    概览提示词生成器使用提示词模板提示词优化器清晰直接使用示例（多样本提示）让 Claude 思考（思维链）使用 XML 标签赋予 Claude 角色（系统提示词）链式复杂提示长上下文技巧扩展思考技巧
    测试与评估
    定义成功标准开发测试用例使用评估工具降低延迟
    加强安全护栏
    减少幻觉提高输出一致性防范越狱攻击流式拒绝减少提示词泄露保持 Claude 角色设定
    管理与监控
    Admin API 概览数据驻留工作空间用量与成本 APIClaude Code Analytics API零数据留存
    Console
    Log in
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...
    Loading...

    Solutions

    • AI agents
    • Code modernization
    • Coding
    • Customer support
    • Education
    • Financial services
    • Government
    • Life sciences

    Partners

    • Amazon Bedrock
    • Google Cloud's Vertex AI

    Learn

    • Blog
    • Catalog
    • Courses
    • Use cases
    • Connectors
    • Customer stories
    • Engineering at Anthropic
    • Events
    • Powered by Claude
    • Service partners
    • Startups program

    Company

    • Anthropic
    • Careers
    • Economic Futures
    • Research
    • News
    • Responsible Scaling Policy
    • Security and compliance
    • Transparency

    Learn

    • Blog
    • Catalog
    • Courses
    • Use cases
    • Connectors
    • Customer stories
    • Engineering at Anthropic
    • Events
    • Powered by Claude
    • Service partners
    • Startups program

    Help and security

    • Availability
    • Status
    • Support
    • Discord

    Terms and policies

    • Privacy policy
    • Responsible disclosure policy
    • Terms of service: Commercial
    • Terms of service: Consumer
    • Usage policy
    管理与监控

    用量与成本 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 密钥。

    Was this page helpful?

    • 用量 API
    • 成本 API
    • Workbench 使用情况如何处理？
    • 如何获取 Claude Code 的按用户成本明细？
    合作伙伴解决方案

    领先的可观测性平台提供开箱即用的集成，用于监控您的 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 作为过滤值来定位这些模型。

    时间粒度限制

    粒度默认限制最大限制使用场景
    1m60 个桶1440 个桶实时监控
    1h24 个桶168 个桶每日模式
    1d7 个桶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"

    分页

    两个端点都支持大数据集的分页：

    1. 发起初始请求
    2. 如果 has_more 为 true，在下一个请求中使用 next_page 值
    3. 继续直到 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% 折扣
    • 速率限制 - 了解使用层级
    • 数据驻留 - 控制推理地理位置