跳转到主要内容
Admin Key(管理 Key)让脚本以编程方式管理你自己的账号:查余额、导出调用日志、统计用量、轮换 API 密钥。
Admin Key 不能用来调用模型。 它和 API 密钥是两种完全不同的凭据,用错了会直接报错。

创建

1

进入管理 Key 页面

登录 控制台,在侧边栏选择 构建与使用 → 管理 Key。
2

填写名称并选择作用域

起一个能认出用途的名字,例如「对账脚本」。然后只勾选这个脚本真正需要的作用域,默认勾选的三项都是只读的。作用域清单见作用域。
3

选择有效期

可选 7 天、30 天、90 天、365 天、自定义天数或永不过期。
4

立即保存明文

创建成功后完整内容只显示这一次。关闭对话框之后无法再次查看,系统只保存它的哈希值。

认证方式

把 Admin Key 放进 Authorization 请求头:
响应是标准的 JSON 信封:
success 为 false 时,message 里是可读的失败原因,部分错误还带 code 字段。

能力边界

Admin Key 能做什么完全由你勾选的作用域决定。除此之外还有三条无论勾选什么都不可逾越的边界:

碰不到管理后台

管理端、代理商端、供应商端的全部接口一律拒绝,与账号角色无关。管理员账号的 Admin Key 同样只能做用户端的事。

改不了账号安全

改密码、删除账号、双因素、Passkey、手机与邮箱绑定、实名认证,全部拒绝。

动不了钱和密钥明文

充值、提现、支付方式、发票提交一律拒绝;已有 API 密钥的明文也永远取不到。

生命周期

  • 数量上限:同一账号最多同时存在 10 枚有效的 Admin Key,每天最多创建 5 枚。
  • 可以编辑:创建之后可以修改名称和作用域。有效期不可修改 —— 需要换期限请重新创建一枚。
  • 随时撤销:可以单独撤销某一枚,也可以一次撤销全部。撤销立即生效,不可恢复。
  • 改密码即全部失效:修改账号密码会让名下全部 Admin Key 立即失效,包括选了永不过期的那些。

怀疑泄露了怎么办

1

立即撤销

到管理 Key 页面点「撤销全部」。这个动作同时会把你在其他设备上的登录一并登出。
2

检查审计日志

在 构建与使用 → 审计日志 里查看这枚 Key 的使用记录,包括首次使用时间和来源 IP。
3

重新创建

用更小的作用域和更短的有效期重新创建,只勾脚本真正用得到的那几项。
系统会在一枚 Key 频繁触碰能力边界时自动记录审计。持续被拒通常意味着两件事之一:脚本配错了作用域,或者这枚 Key 落到了不知道它边界的人手里。