Skip to content

什么是 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 请求头:

bash
curl https://api.calgine.com.cn/api/user/self \
  -H "Authorization: Bearer sk-admin-your-key"

响应是标准的 JSON 信封:

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 落到了不知道它边界的人手里。