什么是 Admin Key
用于让脚本以编程方式管理你自己账号的长期凭据,不是调用模型用的密钥。
Admin Key(管理 Key)让脚本以编程方式管理你自己的账号:查余额、导出调用日志、统计用量、轮换 API 密钥。
Admin Key 不能用来调用模型。 它和 API 密钥是两种完全不同的凭据,用错了会直接报错。
| API 密钥 | Admin Key | |
|---|---|---|
| 前缀 | sk- | sk-admin- |
| 用途 | 调用模型 | 管理账号 |
| 请求地址 | /v1/... | /api/... |
| 会消耗额度 | 是 | 否 |
创建
1. 进入管理 Key 页面
登录 Calgine Tokens 控制台,在侧边栏选择 构建与使用 → 管理 Key。
2. 填写名称并选择作用域
起一个能认出用途的名字,例如「对账脚本」。然后只勾选这个脚本真正需要的作用域,默认勾选的三项都是只读的。作用域清单见权限范围。
3. 选择有效期
可选 7 天、30 天、90 天、365 天、自定义天数或永不过期。
4. 立即保存明文
创建成功后完整内容只显示这一次。关闭对话框之后无法再次查看,系统只保存它的哈希值。
认证方式
把 Admin Key 放进 Authorization 请求头:
curl https://api.calgine.com.cn/api/user/self \
-H "Authorization: Bearer sk-admin-your-key"响应是标准的 JSON 信封:
{
"success": true,
"message": "",
"data": { "username": "...", "balance": "12.3456", "...": "..." }
}success 为 false 时,message 里是可读的失败原因,部分错误还带 code 字段。
能力边界
Admin Key 能做什么完全由你勾选的作用域决定。除此之外还有三条无论勾选什么都不可逾越的边界:
碰不到管理后台
管理端、代理商端、供应商端的全部接口一律拒绝,与账号角色无关。管理员账号的 Admin Key 同样只能做用户端的事。
改不了账号安全
改密码、删除账号、双因素、Passkey、手机与邮箱绑定、实名认证,全部拒绝。
动不了钱和密钥明文
充值、提现、支付方式、发票提交一律拒绝;已有 API 密钥的明文也永远取不到。
生命周期
- 数量上限:同一账号最多同时存在 10 枚有效的 Admin Key,每天最多创建 5 枚。
- 可以编辑:创建之后可以修改名称和作用域。有效期不可修改——需要换期限请重新创建一枚。
- 随时撤销:可以单独撤销某一枚,也可以一次撤销全部。撤销立即生效,不可恢复。
- 改密码即全部失效:修改账号密码会让名下全部 Admin Key 立即失效,包括选了永不过期的那些。
怀疑泄露了怎么办
1. 立即撤销
到管理 Key 页面点「撤销全部」。这个动作同时会把你在其他设备上的登录一并登出。
2. 检查审计日志
在 构建与使用 → 审计日志 里查看这枚 Key 的使用记录,包括首次使用时间和来源 IP。
3. 重新创建
用更小的作用域和更短的有效期重新创建,只勾脚本真正用得到的那几项。
系统会在一枚 Key 频繁触碰能力边界时自动记录审计。持续被拒通常意味着两件事之一:脚本配错了作用域,或者这枚 Key 落到了不知道它边界的人手里。