Management API Keys
Management API Key 用于管理团队全部项目、预算和模型 API Key,并查询项目和 Key 用量。
Management API Key 用于管理团队全部项目、预算和模型 API Key,并查询项目和 Key 用量。
各接口使用哪种 Key?
此对照仅比较两种 API Key;已启用的 OAuth scoped token 仍可按原规则用于计费查询。
创建管理 Key
- 登录控制台,切换到你担任 Owner 的团队账户。
- 在侧栏 Developer(开发者) → Management API Keys 打开管理页,也可以直接前往。此入口仅对当前团队 Owner 显示。
- 填写 Name,按需设置 Expires (optional),点击 Create key。
- 点击 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