余额管理与额度分配
适用角色：组织（顶层用户） 更新日期：2026-07-02
本文是 CloudRouter 新版控制台资金体系的"总纲"，讲清两件事：组织余额池怎么管，以及怎么给子用户设额度上限。
⚠️ 重要观念变化：新版不再有"成员个人钱包"。组织余额池是唯一资金来源；给子用户设的是额度上限（配额），不是把钱分出去。理解这一点，下面的操作就都顺了。
一、核心概念：一个池子，多个额度上限
新版控制台采用「组织余额池 + 子用户额度上限」的两段式资金模型：
- 充值（在线/兑换码）的资金进入组织余额池，这是整个组织唯一的资金来源
- 组织可为名下每个子用户设置额度上限，封顶该子用户的消费（比如子用户 A 上限 200，子用户 B 上限 500）
- 子用户调用模型时，真实扣的始终是组织余额池的余额，而非子用户自己的钱包——额度上限只是"最多能花多少"的封顶阀门
| 概念 | 是什么 | 不是什么 |
|---|---|---|
| 组织余额池 | 整个组织唯一的资金来源；组织自身与全部子用户的消费都从这里扣 | 不是多个钱包的集合 |
| 子用户额度上限 | 给子用户设的消费封顶值（配额），控制"它最多能花多少" | 不是一个独立钱包，不是"把钱划给它" |
| 真实扣费 | 子用户调用模型时，扣的始终是组织余额池的余额 | 不是先扣子用户钱包、再扣组织池 |
一句话理解：额度是"封顶阀门"，余额池是"唯一油箱"。 给子用户设额度，等于规定它最多能从油箱里抽多少油，而不是把油分到它自己的小油箱里。
与老版的区别（重要）
老版（v1）讲"把组织余额池的积分分配给成员个人余额，成员从个人余额扣"。新版（v2）不再这样：
| 维度 | 老版 v1（成员个人余额） | 新版 v2（子用户额度上限） |
|---|---|---|
| 给成员/子用户的东西 | 一笔划过去的钱（个人钱包） | 一个消费封顶值（配额） |
| 消费时扣谁 | 扣成员个人余额 | 扣组织余额池 |
| 设额度时组织池变化 | 立即扣减组织池 | 不扣减，仅设上限 |
| 多把 Key | — | 子用户名下多把 Key 共享同一额度上限 |
如果你从老版迁移过来，请不要再用"把钱分给成员"的思路理解。新版是"封顶额度 + 实扣组织余额"。
二、谁能做什么
✅ 可操作 ｜ ❌ 无权限 ｜ 🔸 仅限本组织范围
| 能力 | 组织 | 子用户 |
|---|---|---|
| 给组织余额池充值（在线/兑换码） | ✅ 🔸 | ❌ |
| 给子用户设/调额度上限 | ✅ 🔸 | ❌ |
| 回收/清零子用户额度 | ✅ 🔸 | ❌ |
| 查看组织余额与流水 | ✅ 🔸 | ❌ |
| 查看自己的额度（只读） | — | ✅ 🔸 |
子用户在「API 密钥」页顶部有一张只读的额度卡片，能看到自己的额度用量，但不能修改。完整角色边界见 角色与权限矩阵。
三、查看组织余额与流水
进入余额管理页（组织登录后左侧导航栏），可查看：
- 当前组织余额，以及充值、刷新等操作入口
- 完整的余额变动流水
余额流水类型对照表
| 类型 | 方向 | 说明 |
|---|---|---|
| 购买 | +组织池 | 通过「购买」页在线支付充入 |
| 兑换码 | +组织池 | 通过「兑换码」页兑换充入 |
| 充值 | +组织池 | 平台直接为组织充值 |
| 优惠码 | +组织池 | 通过优惠码（如注册赠送）充入 |
| 消费 | -组织池 | 组织自身或子用户调用模型的扣减 |
| 退款 | -组织池 | 退款操作的扣减 |
每条流水通常包含：时间、类型、金额、说明、相关用户、操作人、变动前余额、变动后余额，可作为审计依据。
注意：新版子用户消费直接扣组织余额池，因此"消费"流水反映的是组织池的减少。老版那种"分配（组织池→成员）/回收（成员→组织池）"的资金搬运流水，在新版已不再产生——给子用户设额度不会生成资金搬运记录。
四、给子用户设/调额度上限
给子用户设额度的操作在子用户管理页完成（不是把钱划走，而是设封顶值）。
操作步骤
- 左侧导航栏 → 子用户管理
- 找到目标子用户，进入其编辑 / 额度设置入口
- 设置额度上限：填写该子用户最多可消费的额度值
- 保存后即时生效
具体字段名（如"额度上限""配额"）、是否支持周期性额度等以控制台实际界面为准。子用户的创建、停用、业务身份设置等完整操作见 子用户管理。
关键规则
- 设额度不扣组织池：设额度只是规定子用户的消费上限，组织余额池不会因此减少
- 共享同一额度上限：同一子用户名下的多把 Key 共享其额度上限，不是每把 Key 各有额度
- 实扣组织余额：子用户每次调用，真实扣的是组织余额池；额度上限只决定"它累计还能花多少"
- 额度可随时调整：上调、下调均即时生效；下调到低于已消费值时，该子用户将无法继续调用
- 组织自身消费不受额度限制：额度面向子用户，组织（顶层用户）自身调用直接走组织余额池
五、子用户额度用尽 / 余额不足的表现
这是两种不同的"花完了"，表现不同：
| 情形 | 触发条件 | 表现 |
|---|---|---|
| 子用户额度用尽 | 某子用户累计消费达到其额度上限 | 该子用户名下全部 Key 一并被拒，组织其他子用户不受影响 |
| 组织余额池不足 | 组织余额池余额不足以支付本次调用 | 全组织调用受影响，接口返回 HTTP 403（余额类，具体错误码以接口实际返回为准） |
⚠️ 子用户额度用尽是按子用户生效，不是按单把 Key——因为多把 Key 共享同一额度上限，所以一旦额度耗尽，该子用户的所有 Key 都会被拒。要恢复，给它上调额度上限即可（前提是组织池仍有余额）。
要限制某个子用户调用，有两种办法：
- 调低 / 用尽其额度上限：其名下全部 Key 一并被拒
- 停用该子用户账号：见 子用户管理
六、回收 / 调整额度
新版没有老版那种"从成员钱包把钱收回组织池"的资金回收动作——因为钱本来就一直在组织池里。新版的"回收"本质是调整子用户的额度上限：
| 你的目的 | 新版做法 |
|---|---|
| 不想让某子用户再花 | 把其额度上限下调或清零（其名下全部 Key 随即被拒） |
| 子用户离职 / 停用 | 停用子用户账号；其历史用量归集到所属组织 |
| 临时收紧预算 | 统一下调相关子用户的额度上限 |
- 调整额度上限即时生效，不涉及组织池资金搬运
- 删除子用户后，其历史用量归集到所属组织，不在用户维度单独保留
七、典型资金运营流程
新团队启动
充值到组织余额池 → 创建子用户 → 分别设额度上限（如各 200）→ 创建 Key → 子用户开始调用控制某子用户花销
子用户管理 → 下调其额度上限 → 其名下全部 Key 在额度用尽点被拒子用户离职
子用户管理 → 停用 / 删除该子用户 → 其历史用量归集到组织 → 组织池余额不受影响月度对账 / 开票
余额管理查流水 → 我的订单下载凭证 → 飞书问卷申请发票（见《发票与凭证》）八、常见问题
Q：给子用户设额度，会从组织余额池扣钱吗？
A：不会。设额度只是设一个消费上限（封顶值），组织池余额不变。只有子用户真正调用模型时，才会从组织池实扣。
Q：子用户有自己的钱包/余额吗？
A：没有。新版子用户没有独立钱包，只有一个"额度上限"。它能看到自己的额度用量（只读卡片），但所有消费都扣组织余额池。
Q：子用户名下多把 Key，额度是各算各的还是合在一起？
A：合在一起。同一子用户的多把 Key 共享同一额度上限，累计消费一起计入它的额度上限。
Q：所有子用户额度上限加起来，可以超过组织余额吗？
A：可以。额度上限是"封顶阀门"，不是预扣资金，因此各子用户额度之和允许大于组织余额（相当于"授信不预占"）。但真实扣费时扣的是组织池——一旦组织池耗尽，会返回 HTTP 403（余额类），所有人都受影响。请结合实际预算合理设置。
Q：子用户额度用尽了，怎么恢复它的调用？
A：在子用户管理页给它上调额度上限即可，前提是组织余额池仍有余额。
Q：我想"收回"分给子用户的额度，怎么操作？
A：新版没有资金回收概念。你只需在子用户管理页下调或清零它的额度上限——钱一直在组织池里，从未离开。
Q：组织自己调用模型，受额度上限约束吗？
A：不受。额度上限是给子用户设的，组织（顶层用户）自身调用直接走组织余额池。
Q：平台能直接给我的组织充值吗？
A：可以。平台可为组织余额池直充（流水显示为"充值"类型），如有需要请联系 CloudRouter。但给子用户设额度通常由你作为组织自行操作。
九、注意事项
- 组织余额池是唯一资金来源，子用户没有独立钱包
- 给子用户设额度是设消费上限，不扣组织池、不搬运资金
- 子用户多把 Key 共享同一额度上限；额度用尽时其名下全部 Key 一并被拒
- 真实扣费始终扣组织余额池；组织池不足时调用返回 HTTP
403（余额类，具体错误码以接口实际返回为准） - 提升组织级并发上限、调整可用模型范围等需联系 CloudRouter，见 角色与权限矩阵
- 所有余额变动都在流水中留痕，可作为审计依据
联系我们
- 电子邮箱：support_cloudrouter@clouditera.com
- QQ 社群：712273971
- 平台网址：cloudrouter.online