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

​
概览

分析 API v2 是 Devin Desktop 分析 API 的新一代版本。它通过简洁的 REST 端点提供用量 分析 (credits 和 ACU) ，并支持按查询参数过滤、灵活分组、基于游标的分页以及响应缓存。
在 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 > Service users (组织) 或 Enterprise settings > 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 字段。 列表响应采用分页形式返回。当有更多数据时，响应中会包含 pagination.next_page_cursor；将其作为 page_cursor 查询参数传回，以获取下一 页。游标会在 24 小时后失效。

​
缓存

响应中会包含一个 ETag 标头。在后续请求中，通过 If-None-Match 标头将其发回； 如果数据未发生变化，则会收到 304 Not Modified。

​
速率限制

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