子账号管理
子账号让你把自己账户下的 API Key 分发给团队成员、项目组或下游使用者,让他们各自登录、只读查看被授权的 Key 及其调用日志与用量,而无需共享主账号密码,也不会让他们动到充值、令牌增删、额度转移等敏感操作。
适用场景
- 团队/部门内多人共用一个账户,但希望每人只看到分配给自己的 Key 和用量。
- 把某个 Key 交给下游客户或某个项目,单独跟踪它的消费。
- 需要给他人查看权限,但不想暴露主账号登录凭据。
能力边界
| 操作 | 主账号 | 子账号 |
|---|---|---|
| 登录控制台 | ✓ | ✓ |
| 查看被授权令牌列表 | ✓ | ✓ |
| 查看 / 复制被授权令牌的完整密钥 | ✓ | 由开关控制,默认不可 |
| 查看被授权令牌的调用日志与按日用量 | ✓ | ✓ |
| 创建 / 修改 / 删除令牌 | ✓ | ✗ |
| 充值、兑换、转移额度 | ✓ | ✗ |
| 创建和管理子账号 | ✓ | ✗ |
子账号本身不持有额度,也不参与邀请。它能调用模型,用的是主账号授权给它的令牌。
创建子账号
在控制台「子账号管理」页点击新建,填写:
- 用户名:子账号的登录名,需全站唯一。
- 密码:8–20 个字符。
- 显示名称:便于识别的备注名(可选,最长 20 字符)。
创建后子账号即可用该用户名和密码登录控制台。
把令牌指派给子账号
在「令牌管理」中编辑某个令牌,展开「授权子账号」,搜索并选择一个子账号即可。
- 一个令牌至多归属一个子账号;一个子账号可以持有多个令牌。
- 授权子账号选择框是输入即搜的,支持成百上千个子账号,无需下拉整表。
- 指派后,该子账号登录即可在自己的令牌列表看到这个令牌,并查看它的调用日志与按日用量;能否看到完整密钥取决于该子账号的「允许查看密钥」开关(见下)。
要收回授权,把该令牌的「授权子账号」清空即可。
设置消费上限
每个子账号可以单独设置一个消费上限:
- 上限按当前站点的展示货币金额填写,
0表示不限。 - 子账号列表以「已用 / 上限」进度条展示,接近上限时颜色会变化以示提醒。
- 已用金额从指派之后开始累计,指派前该令牌的历史用量不计入。
上限既可以在新建时由默认值继承,也可以在列表中随时就地修改。
是否允许查看密钥
每个子账号有一个独立的「允许查看密钥」开关,默认关闭:
- 关闭时,子账号在令牌列表只能看到掩码后的密钥(形如
sk-abcd****xyz),无法查看或复制完整密钥,但日志与用量查看不受影响。适合「只给他看用量、不把 Key 交出去」的场景。 - 开启后,子账号可以查看并复制被授权令牌的完整密钥。
- 开关在「子账号管理」列表中随时切换,即时生效。
日常管理
在「子账号管理」页可以:
- 按用户名 / 显示名搜索,按启用 / 禁用状态筛选,分页浏览。
- 就地修改显示名称与消费上限。
- 切换「允许查看密钥」开关。
- 启用 / 禁用子账号(禁用后该子账号无法登录)。
- 重置子账号密码。
- 删除子账号——删除会同时收回它名下的全部令牌授权。
每个主账号可创建的子账号数量有上限(默认 50,具体以站点为准)。
子账号登录后能看到什么
子账号登录后只保留与「被授权令牌」相关的只读视图:
- 令牌列表:查看被授权的令牌;若已开启「允许查看密钥」,还可查看并复制完整密钥。
- 日志与用量:查看这些令牌的调用日志和按日用量(参见「日志查询与导出」)。
充值、令牌增删改、额度转移、子账号管理等入口对子账号不可见。
注意事项
- 密钥一旦被复制走,即使之后解除授权或关闭「允许查看密钥」,已经拿到的密钥仍可继续使用。若需让其彻底失效,请在「令牌管理」中重置或删除对应令牌。
- 「允许查看密钥」默认关闭。若子账号只需要看用量和日志,保持关闭即可,密钥不会经它外泄。
- 消费上限用于约束子账号在指派之后产生的用量,历史用量不纳入统计。
- 子账号无法自助找回密码,如遗忘请由主账号在「子账号管理」中重置。