密钥与鉴权
本页面向:企业成员与企业管理员。 创建和管理企业共享密钥的完整操作在共享 API 密钥。
两种密钥,扣的钱不一样
这是最需要先弄清楚的一件事:
| 个人密钥 | 企业共享密钥 | |
|---|---|---|
| 在哪管理 | 控制台的「API 密钥」页(/keys) | 企业控制台 → 共享 API 密钥(/org/tokens) |
| 归属 | 你个人 | 整个企业,不归到某个成员名下 |
| 扣谁的钱 | 你个人账户的余额 | 企业的共享余额 |
| 企业余额不足时 | 不适用 | 不会回落到你的个人钱包 |
| 受什么约束 | 你个人的额度与订阅 | 密钥自身的额度 |
| 谁能创建 | 你自己 | 企业管理员(成员通常看不到这一页) |
共享密钥不走个人钱包回落。 它用的是企业余额;企业余额不足时请求会被拒绝,而不是转去扣使用者的个人余额。所以给同事发共享密钥,等于把企业的余额交给对方使用——发放前请确认密钥额度。
个人成员的实际消费走哪一侧,由企业的计费策略决定:企业为成员开启企业计费时默认扣企业余额,并且只有在企业允许「个人钱包回落」时,企业余额不足才会转扣成员自己的余额。这些开关在企业设置里。
鉴权方式
按 OpenAI 兼容约定,在请求头里带上密钥:
Authorization: Bearer sk-...Base URL 为:
| 用途 | 地址 |
|---|---|
| OpenAI 兼容接口 | https://alltokens.si/v1 |
| 网关健康检查(不需要密钥) | https://alltokens.si/api/status |
密钥状态
控制台里每个密钥会显示状态,含义如下:
| 状态 | 含义 | 怎么处理 |
|---|---|---|
| 启用 | 正常可用 | — |
| 停用 | 被手动关闭,请求会被拒 | 需要时重新启用 |
| 过期 | 超过设定有效期 | 新建一个 |
| 用尽 | 已达到该密钥的额度上限 | 追加额度或新建 |
安全建议
- 密钥等同于余额。不要写进代码仓库、不要贴进聊天群、不要放进前端页面或浏览器里。
- 用环境变量或密钥管理服务注入,不要硬编码。
- 不同用途用不同密钥,这样一个泄露时只影响一处,也便于在请求明细里分辨来源。
- 怀疑泄露时立即停用或删除该密钥,再新建一个。
- 密钥明文通常只在创建时完整显示一次,请当场保存好。