余额管理与额度分配

适用角色：主用户 更新日期：2026-08-06

组织内的按量调用共用一份积分余额（总额度池）。主用户为子用户设置的是消费额度池上限，不会把余额转入子用户账户。

充值方式见 充值与兑换码，消费明细见 账单与用量监控。

余额和额度的关系

项目	含义
组织余额	组织可用于按量调用的剩余积分
子用户额度	子用户在指定范围内最多可消费的积分
实际扣费	请求完成后从组织余额中扣除，同时计入子用户已用额度

设置或提高子用户额度不会立即扣减组织余额。只有子用户实际发起调用时才产生费用。因此，所有子用户的额度池上限之和可以高于当前组织余额；组织余额不足时，按量调用仍会受到影响。

订阅型 Key 使用独立的订阅额度，具体规则见 订阅管理与成员分配。

查看组织余额

打开左侧菜单「余额管理」。页面中的统计卡展示额度池、累计购买积分和累计赠送积分，下方的余额变更记录用于查询充值与消费流水。

余额管理页是查询页面。充值在「兑换」或「充值/订阅」页面进行；子用户额度在「子用户管理」中设置。

设置子用户额度

1. 打开「子用户管理」；
2. 找到目标子用户并点击「编辑」；
3. 填写额度池上限；
4. 保存设置。

需要同时调整多人时，可以使用列表工具栏中的批量设置功能。额度保存后立即影响后续请求，不会修改已经产生的使用记录。

多把 Key 共用该子用户的额度。为不同应用创建多把 Key 有助于追踪来源，但不会增加可消费总额。

额度用完后的表现

情况	影响范围	处理方式
子用户额度用完	该子用户的按量型 Key	主用户提高额度，或改用有效的订阅型 Key
组织余额不足	组织内的按量调用	为组织充值
单把 Key 的额度用完	该 API Key	调整 Key 限额，或更换 Key
订阅额度用完或到期	绑定该订阅的 Key	等待订阅额度重置、续订或调整订阅

接口返回内容可能因触发条件不同而变化。排查时可结合 API Key 页的状态、计费来源和接口响应中的 code 判断。

调整或收回额度

需要限制某个子用户的后续消费时，可以降低其额度池上限或禁用账户。降低额度不会产生余额转移记录；删除子用户前，应先确认其 API Key 和应用已经禁用。

历史使用记录仍归入组织统计，不会因为额度调整而被删除。

常见问题

设置额度会预扣组织余额吗？
不会。调用实际发生后才扣除余额。

子用户有独立余额吗？
没有。子用户只能查看自己的额度和用量，按量费用从组织余额中扣除。

一名子用户创建多把 Key，会获得多份额度吗？
不会。该用户的多把 Key 共享同一份用户额度，但每把 Key 还可以设置独立限额。

主用户自己的调用受子用户额度限制吗？
不受。子用户额度只作用于对应子用户，主用户调用仍受组织余额和 Key 限制。