子用户管理

适用角色：主用户更新日期：2026-07-21

子用户是你组织名下的调用方（同事、开发者）。这篇讲怎么建子用户、给他设额度、分部门、授权可用分组，以及日常怎么管。

只有主用户能进这个页面。子用户登录后看不到「子用户管理」。

一、什么是子用户

子用户能登录控制台，但菜单少：只有仪表盘、API 密钥、默认模型配置、使用记录、个人资料。
子用户没有自己的钱包。他调用花的钱，扣的是组织余额池（你充的钱）。
你可以给每个子用户设一个额度上限（单位积分），封顶他最多能花多少。
子用户名下不管建几把 Key，都共用他这一份额度。

二、功能入口与三个 Tab

左侧菜单 → 子用户管理（/sub-users）。进去后顶部有三个 Tab：

Tab	用途
子用户列表	建、管所有子用户，最常用
部门管理	按组织架构建树形部门、把子用户归到部门、给部门预设默认额度（详见下文第七节）
设置	组织级的一些开关，比如「分组标识路由」开关（进阶功能，见下文第八节）

子用户管理页面：

子用户管理页面

列表长什么样

工具栏：创建子用户、批量创建、批量设额度、筛选；搜索框占位「搜索用户名 / 邮箱」。

表头这些列：

列	说明
成员	用户名和邮箱
激活状态	已激活 / 未激活（子用户拿激活码注册后才算激活）
额度	你给他设的消费上限
已用额度	他已经花了多少
API Key	他名下有几把 Key
创建时间	建这个子用户的时间
操作	复制、编辑、可用分组、删除

三、创建一个子用户

在「子用户列表」Tab，点「创建子用户」。
在弹窗里填下面这些（大多可留空）：

字段	是否必填	说明
投递邮箱	可选	仅用于把激活码 / 激活链接发到这个邮箱，方便转交给子用户。不是登录邮箱（登录邮箱由子用户激活时自己填）。留空则不自动发信，需要你手动把激活码转交给他
用户名	可选	给他起个内部备注名，方便在列表里认（如「财务部-张三」）。不影响登录和计费，之后也能改
额度池初值（积分）	可选	这个子用户的初始消费上限。留空 = 用组织默认；填 0 一般表示不限额（以控制台实际为准）
归属部门（可多选）	可选	点「点击选择部门」把他归到一个或多个部门（部门先在「部门管理」Tab 建好）。这里只是创建时顺手归一下，之后随时能在「部门管理」Tab 加人 / 移人
RPM 限制	可选	他的 Key 每分钟最多调用多少次。留空不限
并发限制	可选	他的 Key 同一时刻最多同时处理多少个请求。留空不限
激活码永不过期	可选	勾上则激活码不过期；不勾默认有个有效期（以控制台实际为准）

点「创建」。

点「创建子用户」后弹出的配置窗口：

创建子用户

⚠️ 创建成功后，会一次性显示这个子用户的激活码（以及初始 API Key）。这个信息只显示这一次，请当场复制保存好，用完弹窗就看不到了。 具体展示内容以控制台实际为准。

四、子用户怎么激活、怎么登录

子用户不走公开注册页，而是靠你给的激活码注册：

你建好子用户后，拿到激活码（填了投递邮箱的话会发到那个邮箱，没填就手动复制转交）。
通过安全渠道把激活码给对应的同事。
他打开激活页面，用激活码注册、设好自己的登录邮箱和密码。
激活完成，他就能登录了，此时列表里「激活状态」变成「已激活」。

激活码请通过安全渠道给，别被无关的人拿去用了。

五、给子用户设 / 调额度

额度就是这个子用户最多能花多少（单位积分），设在创建或编辑子用户的时候。要点：

设额度不等于把钱分出去。 钱一直在组织余额池里，额度只是一个「最多花多少」的封顶阀门。
真正扣的是组织余额池。 子用户调用产生的费用，从组织的钱里扣。
名下多把 Key 共用一份额度。 不是每把 Key 各有一份。
额度用尽，他名下全部 Key 一起被拒，直到你给他调高额度（前提是组织池还有钱）。
调额度即时生效，上调下调都是。

批量场景可以用工具栏的「批量设额度」一次给多个子用户设。资金和额度的完整说明见余额管理与额度分配。

六、管理已有子用户

在「子用户列表」里，每个子用户的行操作有：

复制 —— 快速复制该子用户信息（如邮箱 / 用户名），方便转交或记录。
编辑 —— 改用户名、额度上限、RPM 限制、并发限制，以及状态（启用 / 禁用）。（注：投递邮箱在编辑里改不了。归属部门也不在这里改——它在「部门管理」Tab 里通过加人 / 移人调整，见第七节。）
可用分组 —— 授权这个子用户能用哪些分组。他建 Key 时，下拉里只会出现你在这里授权给他的分组。想让他用某个分组，先在这里加上。
删除 —— 把这个子用户从组织里移除。

想限制某个子用户？ 三种办法：在「编辑」弹窗里把状态改成「禁用」，他立刻登录不了、名下 Key 一并停用；或调低 / 用尽他的额度上限（额度一空，名下全部 Key 一起被拒）；或直接删除。

⚠️ 删除后用量归集：子用户被删掉后，他的历史用量会归到组织名下，不再单独按这个人保留。要留逐人明细的话，删之前先导出核对。

七、部门管理

「部门管理」是「子用户管理」页里的第二个 Tab（/sub-users/departments），用来把子用户按组织架构分到不同部门，方便按部门归拢人、给部门预设子用户默认额度。部门是树形层级：可以有根部门、子部门，多层嵌套。

部门是可选的组织方式，不建部门也完全能正常用子用户。人不多时可以先不管这个 Tab。

部门管理页面（示例：研发部 ▸ 前端组 / 后端组、财务部）：

部门管理

页面结构（左右两栏 + 顶部搜人）

左侧「部门树」：整个组织的部门层级，每个部门后面显示人数（如「3 人」），可展开 / 收起、刷新。没有部门时提示「暂无部门，点击『新建根部门』开始」。
右侧「部门成员」：点左侧某个部门后，右边列出该部门成员。没选部门时提示「请在左侧选择一个部门查看其成员」。
顶部「跨部门搜人」框：在整个组织里找某个人、看他属于哪些部门（连未分配部门的人也能搜到）。

建 / 改 / 删部门

在部门树上操作：

新建根部门 / 新建子部门：在某个部门下点「新建子部门」，就挂在它下面形成层级。
编辑：改部门名称，以及设「子用户默认额度上限」（见下）。
删除：删之前要先清空——该部门下还有子部门、或还有成员，都不能直接删，系统会提示你先移除。
部门层级可调整，但不能把一个部门移到它自己或它的下级里（会形成循环，系统会拦下）。

部门成员：加人 / 移人

添加成员：在右侧点「添加成员」，勾选要加进这个部门的子用户（可搜邮箱 / 用户名）。一个子用户可以同时属于多个部门。
移出部门：把某人从当前部门移出——只是移出这个部门，不影响他的账号，也不影响他在别的部门的归属。
成员列表列：邮箱、用户名、业务账号、操作；每人还会标出所属部门。状态分正常 / 已停用 / 待激活，人多时分页看。

记住：部门归属在这个 Tab 里管，不在「子用户列表」的编辑弹窗里改。 创建子用户时能顺手选好部门，之后要调整就来这里加人 / 移人。

部门默认额度上限（省事的批量默认值）

建 / 改部门时可以填一个**「子用户默认额度上限」**。作用是：以后在这个部门下新建子用户、又没单独填额度时，自动套用部门的这个默认值，不用一个个填。规则：

留空 = 继承（先看本部门 → 上级部门 → 组织默认 → 最后是 0）。
填 0 = 不限额。
填具体数字 = 用这个值。
一个人同时属于多个部门时，取其中最大的那个限额。
⚠️ 只在「创建子用户那一刻」生效，不会改动已有成员的额度。 已有子用户要调额度，仍去「子用户列表」编辑，或用「批量设额度」。

八、进阶：分组标识路由开关（多数人用不到）

「设置」Tab 里有个分组标识路由开关。它是个进阶功能，开了之后，你和子用户可以用「带识别码」的完整写法临时点名走某个分组（详见 API Key 与路由分组）。

这个开关只有你（主用户）能开关，子用户只能跟着你的设置走、自己改不了。
关着的时候，「调用指南」菜单会隐藏、带识别码的调用会被拒——但不影响大家用普通模型名正常调用。
关闭时通常有二次确认；开启即时生效。以控制台实际为准。

这个开关在两个地方都能操作：这里的「设置」Tab，以及「API 密钥」页顶部。

九、关于「邀请链接」

老版那种「邀请链接 / 邀请管理」现在没有对应入口。纳入同事请统一走「创建子用户 + 激活码」。

十、常见问题

Q：子用户能自己建 Key 吗？ A：能。他在「API 密钥」页点「创建密钥」就行，只是能选的分组限于你授权给他的范围。

Q：怎么让某个子用户用某个分组？ A：在他那行点「可用分组」授权。授权后他建 Key 时下拉里才会出现这个分组。

Q：怎么限制某个子用户？ A：在「编辑」弹窗把状态改成「禁用」（他立刻登录不了、名下 Key 一并停用）；或调低 / 用尽他的额度上限（额度一空，名下全部 Key 一起被拒）；或直接删除。

Q：子用户多把 Key 是各算各的额度吗？ A：不是。名下全部 Key 共用同一份额度，一起累计。

Q：删除子用户后他的用量还在吗？ A：会归集到组织名下，不再单独按人保留。要留明细就删之前先导出。

Q：用户名能重复吗？ A：目前不做重名校验，建议自己约定命名规范避免混淆。

Q：创建后的激活码 / API Key 忘记复制了怎么办？ A：那一次性展示的内容看不回来了。激活码可视情况重新获取或重建子用户，具体以控制台实际为准。

Q：一定要建部门吗？ A：不用。部门是可选的组织方式，主要方便按部门归拢人、给部门预设子用户默认额度。人不多时可以完全不建部门。

Q：一个子用户能同时属于多个部门吗？ A：能。在「部门管理」里可以把同一个人加进多个部门。涉及部门默认额度时，多部门取其中最大的限额。

Q：删掉一个部门，里面的人会被删掉吗？ A：不会。而且部门下只要还有成员或子部门就不允许删——要先把成员移出、把子部门处理掉，才能删这个部门。移出部门只是解除归属，不影响子用户账号本身。