Management API Keys

Management API Key 用于管理团队全部项目、预算和模型 API Key,并查询项目和 Key 用量。

Management API Key 用于管理团队全部项目、预算和模型 API Key,并查询项目和 Key 用量。

各接口使用哪种 Key?

此对照仅比较两种 API Key;已启用的 OAuth scoped token 仍可按原规则用于计费查询。

创建管理 Key

  1. 登录控制台,切换到你担任 Owner 的团队账户。
  2. 在侧栏 Developer(开发者) → Management API Keys 打开管理页,也可以直接前往。此入口仅对当前团队 Owner 显示。
  3. 填写 Name,按需设置 Expires (optional),点击 Create key。
  4. 点击 Copy key 保存新生成的 mgmt-...,在后续示例中将它设为 ATLASCLOUD_MANAGEMENT_API_KEY。明文只显示一次。

api_key_id 从哪里获取?

URL 中的 api_key_id 就是创建模型 API Key(POST /public/v1/api-keys)响应中的 id,格式为 ak_...。 请保存这个值,用于后续停用、删除、设置额度和查询用量。响应中的 key(apikey-...)用于模型调用;管理这些 Key 时,请求头仍使用 mgmt-...。

例如创建响应包含以下字段:

{
  "id": "ak_0123456789ABCDEFGHIJKL",
  "key": "apikey-REPLACE_WITH_SECRET_RETURNED_ONCE"
}

后续路径直接填入这个 id,例如 /public/v1/api-keys/ak_0123456789ABCDEFGHIJKL/usage。示例中的 API_KEY_ID 也表示这个值。当前 Public API 不提供 Key 列表,请在创建时保存 id。

调用 Public API

在 Authorization: Bearer 请求头中传入管理 Key。请求使用该 Key 所属的团队账户。

curl -X POST "https://api.atlascloud.ai/public/v1/projects" \
  -H "Authorization: Bearer $ATLASCLOUD_MANAGEMENT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"name":"customer-123"}'

分步开通指南.

管理 Key 的生命周期

停用、删除或过期的管理 Key 无法鉴权。可以在管理页启用或停用未过期的 Key;删除不可撤销。

管理 Key 属于团队,创建者离开团队或不再担任 Owner 时仍然有效;当前 Owner 可以管理前任 Owner 创建的 Key。如需撤销访问,请主动停用或删除对应 Key。

每个团队最多保留 5 个未删除的管理 Key,已停用和已过期的 Key 也计入数量;删除后会释放名额。

Last updated on

On this page