余额管理与额度分配
适用角色：主用户 更新日期：2026-07-21
这篇讲控制台的资金体系，说清两件事：组织余额池怎么看，以及怎么给子用户设额度上限。金额单位都是积分。
⚠️ 一个核心观念：这里没有「子用户个人钱包」。组织余额池是唯一的钱；给子用户设的是额度上限（封顶阀门），不是把钱分出去。想通这点，下面就都顺了。
一、核心概念：一个池子，多个额度上限
打个比方：组织余额池是唯一的一个油箱，子用户额度是各自的一根「最多能抽多少油」的限量阀。
- 你充的钱（兑换码 / 在线充值）都进组织余额池，这是整个组织唯一的钱。
- 你给每个子用户设一个额度上限（比如子用户 A 上限 200 积分，B 上限 500）。
- 子用户调用时，真正扣的是组织余额池，额度上限只决定「他最多还能花多少」。
| 概念 | 是什么 | 不是什么 |
|---|---|---|
| 组织余额池 | 整个组织唯一的钱，谁调用都从这扣 | 不是一堆小钱包的集合 |
| 子用户额度上限 | 给子用户设的消费封顶值 | 不是一个独立钱包，不是「把钱划过去」 |
| 真实扣费 | 子用户调用时扣的是组织余额池 | 不是先扣子用户钱包再扣组织池 |
如果你以前用老版，请别再用「把钱分给成员」的思路——现在是「封顶额度 + 实扣组织余额」。给子用户设额度不会从组织池扣钱，也不会产生资金搬运记录。
二、谁能做什么
| 能力 | 主用户 | 子用户 |
|---|---|---|
| 给组织余额池充值 | ✅ | ❌ |
| 给子用户设 / 调额度上限 | ✅ | ❌ |
| 查组织余额与变更记录 | ✅ | ❌ |
| 查自己的额度（只读） | — | ✅ |
子用户在「API 密钥」页顶部有张只读的「我的额度」卡，能看到自己额度用了多少，但改不了。
三、余额管理页：看余额，但改不了
左侧菜单 → 余额管理（/balance）。这个页面只读——看余额和流水用的，不能在这里充值，也不能在这里给子用户分额度。
页面上有：
三张统计卡：
| 卡 | 含义 |
|---|---|
| 额度池 | 当前组织余额池还剩多少 |
| 已购买总额 | 累计充进来的（充值/订阅） |
| 已赠送总额 | 累计获赠的（活动赠送等） |
下方「余额变更记录」表：
| 列 | 说明 |
|---|---|
| 时间 | 发生时间 |
| 类型 | 这笔是充值、消费还是别的 |
| 变更额 | 加了多少 / 扣了多少 |
| 变后余额 | 这笔之后余额是多少 |
| 备注 | 补充说明 |
没有记录时显示「暂无记录」。
余额管理页面：
想充值请去「兑换」页（或在线充值，见 充值与兑换码）；想给子用户设额度请去「子用户管理」（见下一节）。这两件事都不在余额管理页做。
四、给子用户设 / 调额度
给子用户设额度，是在创建或编辑子用户时做的（不是在余额管理页）：
- 左侧菜单 → 子用户管理。
- 找到目标子用户 → 点「编辑」。
- 设额度池初值 / 额度上限：填他最多能花多少（积分）。
- 保存，即时生效。
批量场景可以用列表工具栏的「批量设额度」一次给多个子用户设。完整子用户操作见 子用户管理。
几条要记住的规则
- 设额度不扣组织池。 只是设个上限，组织池余额不变。只有子用户真调用时才从池子扣。
- 名下多把 Key 共用一份额度。 不是每把 Key 各有一份。
- 实扣的是组织余额池。 额度只决定「累计还能花多少」。
- 额度随时可调。 上调下调即时生效；调到低于已花的值，他就调不了了。
- 你自己调用不受额度限制。 额度是给子用户设的，你自己调用直接走组织余额池。
五、「花完了」的两种情况
| 情况 | 什么时候发生 | 表现 |
|---|---|---|
| 子用户额度用尽 | 某子用户累计消费到了他的额度上限 | 他名下全部 Key 一起被拒，其他子用户不受影响 |
| 组织余额池不足 | 池子里的钱不够付这次调用 | 全组织调用都受影响，直到充值 |
具体的报错提示以接口实际返回为准。子用户额度用尽是按人生效（因为多把 Key 共用一份额度），给他上调额度上限即可恢复（前提是组织池还有钱）。
想限制某个子用户，两个办法：调低 / 用尽他的额度上限，或删除他（见 子用户管理）。
六、「回收」额度怎么理解
这里没有老版那种「从成员钱包把钱收回来」的动作——因为钱一直在组织池里，从没离开。所谓「回收」，本质就是调子用户的额度上限：
| 你想干嘛 | 怎么做 |
|---|---|
| 不想让某子用户再花 | 把他额度上限调低或清零（名下全部 Key 随即被拒） |
| 子用户离职 | 删除这个子用户（历史用量归集到组织） |
| 临时收紧预算 | 统一下调相关子用户的额度上限 |
调额度即时生效，不涉及任何资金搬运。
七、常见问题
Q：给子用户设额度，会从组织池扣钱吗？ A：不会。只是设上限，池子不变。他真调用时才实扣。
Q：子用户有自己的钱包吗？ A：没有。只有一个额度上限。他能看自己额度用了多少（只读），但花的都是组织池的钱。
Q：子用户多把 Key 的额度是各算各的吗？ A：合在一起。名下全部 Key 共用一份额度。
Q：所有子用户额度加起来能超过组织余额吗？ A：能。额度只是封顶阀门，不预扣钱。但真花的时候扣的是组织池——池子一空，谁都受影响。请结合预算合理设。
Q：子用户额度用尽了，怎么恢复？ A：在子用户管理里给他上调额度上限，前提是组织池还有钱。
Q：我自己调用受额度限制吗？ A：不受。额度是给子用户的，你自己调用直接走组织余额池。
Q：平台能直接给我组织充值吗？ A：可以，联系平台即可（余额变更记录里会显示为充值类）。