Skip to main content
v2 API 目前处于 alpha 阶段，内容可能随时变更。

​
概览

分析 API v2 是 Devin Desktop 分析 API 的新一代版本。它通过简洁的 REST 端点提供用量 分析 (credits 和 ACU) 、活跃用户以及 agent 产出 (被接受的代码行数) ，并支持按查询参数过滤、灵活 分组以及基于游标的分页。
在 API 设计最终敲定之前，v2 端点当前使用 /api/v2alpha 前缀提供服务。基础 URL 为 https://server.codeium.com。

​
v2 的新变化

与 v1 相比，最大的变化是身份验证。

​
身份验证

v2 使用 Bearer 令牌 进行身份验证。请将你的凭据放在 Authorization 标头中，而不是放在请求体中：
支持两种凭据：Devin 服务用户 API 密钥 (推荐，即你用于 Devin API 的同一 cog_ 密钥) 或 Windsurf 服务密钥。

​
Devin 服务用户 API 密钥

如果你已在管理 Devin 服务用户，则无需单独配置 Windsurf 凭据：
  1. 在 Settings > Devin API (Service users 选项卡) 中为组织预配服务用户， 或在 Enterprise settings > Devin API (Service users 选项卡) 中为企业预配服务用户
  2. 为其分配包含 Use Local Analytics API 权限的自定义角色 (内置 Admin 角色已包含此权限)
  3. 复制预配完成后显示的 API 密钥，该密钥以 cog_ 开头
  4. 将该密钥用作 Bearer 令牌
结果涵盖该服务用户所属 Devin 账户中的所有内容，metadata.team_id 是该账户的 Devin 团队标识符 (devin-team$<account_id>) 。
group_id 过滤器是 Windsurf teams 中的概念，不支持与 Devin 凭据搭配使用 — 同时使用两者的请求会返回 400 Bad Request。

​
Windsurf 服务密钥

  1. 前往你的团队设置
  2. 进入“Service Keys”部分
  3. 创建一个具有 Analytics Read 权限的新服务密钥
  4. 将该密钥作为 Bearer 令牌放在 Authorization 标头中
支持组作用域的服务密钥——当某个密钥的作用域限定为某个组时，结果会自动 限制在该组内。
请妥善保管这些凭据，切勿在客户端代码或公共代码仓库中暴露它们。

​
可用端点

​
计费策略

用量类响应会根据你团队的计费策略而变化，该策略会在 metadata.billing_strategy 中返回 (产出类和活跃用户类响应不受影响) ：
  • CREDITS — 行中包含 prompt_credits 和 flex_credits
  • ACU — 行中包含 billed_acus
无论采用哪种策略，都会返回 message_count (计费事件数) 和 user_message_count (用户发送的消息数；2026-04-11 之前的用量对应的值为 null) 字段。

​
分页

列表响应采用分页形式返回。当有更多数据时，响应中会包含 pagination.next_page_cursor；将其作为 page_cursor 查询参数传回，以获取下一 页。游标会在 24 小时后失效。

​
速率限制

这些端点不适用于实时用量监测。数据按小时聚合， 且速率限制较低 (每个团队每小时 10 次请求) 。请将它们用于定期报告和批量 导出，而不是实时仪表板或逐请求跟踪。
v2 端点的速率限制为每个团队每小时 10 次请求。超出限制时会返回 429 Too Many Requests，并附带 Retry-After 标头。 对先前查询的分页请求 (沿用 next_page_cursor) 不会计入速率 限制——只有每份报告的初始查询才会计入。较低的限制也说明这些端点 用于定期报告，而非实时监控。