Skip to main content
本文档适用于 Devin 的联邦部署。返回 Devin 文档
联邦 Enterprise Admin 可通过服务密钥 API 以编程方式查询 ACU 用量，并管理组、模型可用性和 ACU 限额。Python SDK 封装了本节所述的所有端点。 组管理和 ACU 上限端点仅适用于自托管的多租户联邦部署，不会在商业部署中提供。分析端点 (/Analytics、/UserPageAnalytics 和 /CascadeAnalytics) 还会检查部署的分析访问层级；没有分析访问权限的团队将收到 permission_denied。

​
基础 URL

所有请求均以 JSON POST 请求的形式发送至你的部署的 API 服务器：
将 <your-server> 替换为你的联邦部署的 API 域名。

​
身份验证

每个请求都需在请求正文中包含服务密钥进行身份验证：
要创建服务密钥，请以团队管理员身份登录联邦门户，前往 设置 → 服务密钥，然后创建一个具备所要调用端点所需权限的密钥。
请妥善保管服务密钥。切勿将其暴露在客户端代码中，也不要将其提交到代码仓库。

​
所需权限

​
团队级和组级密钥

服务密钥在创建时会确定其作用域：
  • 团队级密钥可以查询团队级数据，并管理团队中的所有组。
  • 组级密钥仅限用于其所属的组。它们可以读取该组的 ACU 汇总值和用户记录，仅列出和读取该组，并且只能读取或更新该组当前成员的 ACU 上限。它们无法读取团队级汇总值或用户记录、查看其他组，也无法创建组。
列出组、组成员及用户级 ACU 行的操作均支持分页：
  • page_size — 可选；默认值为 100，最大值为 1,000。省略该参数或传入 0 均会使用默认值。
  • next_page_token — 存在更多结果时返回。在其他请求参数完全相同 (包括相同的 page_size) 的情况下，将其作为 page_token 传回以获取下一页。
页令牌经过加密，且内容不可见。它们会在 24 小时后过期。ACU 消耗令牌与端点、团队、作用域、周期、所选组和页面大小绑定。组列表和成员列表令牌与端点、团队、作用域和页面大小绑定。在不同页面间更改任何绑定值都会返回 invalid_argument 错误。

​
错误

错误以包含代码和消息的 JSON 格式返回：