余额预警与欠费
适用角色：主用户 更新日期：2026-07-21
这篇讲：钱 / 额度花完时会发生什么、怎么提前收到低余额提醒、以及怎么快速恢复。读完你能分清「是没钱了」还是「被限流了」，各自怎么办。
一、花完了会怎样
真正扣费扣的始终是组织余额池。花完分两种情况，表现不一样：
| 情况 | 影响范围 | 怎么恢复 |
|---|---|---|
| 组织余额池不足 | 组织名下所有子用户、所有 Key 都调不了 | 给组织余额池充值 |
| 某子用户额度用尽 | 只有这个子用户名下全部 Key 被拒，别人不受影响 | 给这个子用户上调额度上限（前提是组织池还有钱） |
调用被拒时，接口会返回相应的错误提示。具体错误码 / 文案以接口实际返回为准，本手册不逐一列举。
还有一种「被拒」不是没钱，而是触发了限制：比如某把 Key 开了速率限制、调太频繁，或者瞬时并发太高被限流。这类不是余额问题，处理方式也不同——速率限制等窗口重置，并发不够则需要联系平台调并发上限（见 并发设置）。
一句话区分
- 没钱 / 额度封顶 → 充值，或给子用户上调额度。
- 被限流 / 限速 → 等窗口重置，或降低调用频率 / 并发。
二、低余额提醒：在「个人资料」页配
为了避免余额在你不知情时花光、服务突然断掉，可以开个余额不足提醒：余额降到你设的线时，提前发邮件通知你。
入口在**「个人资料」页**（往下翻到「余额不足提醒」区）。可以配：
| 配置 | 说明 |
|---|---|
| 开关 | 是否启用提醒 |
| 阈值 | 余额低到多少（积分）就提醒；留空则用默认值 |
| 通知邮箱 | 除了你的账户邮箱，还能加收件人（如财务、运维同事）。最多 3 个，每个都要收验证码验证后才生效，可以单独开启 / 关闭 |
建议把财务 / 运维的邮箱也加进来，让相关同事一起收到提醒。具体字段以控制台实际界面为准。
三、快速恢复
充值 / 调额度都是即时生效的，不用重新登录、不用重建 Key：
- 组织余额不足：充值（见 充值与兑换码）后立即到账，下一次请求就能调。
- 某子用户额度用尽：在子用户管理给他上调额度上限，调完立即生效。
欠费期间，历史用量、API Key 配置都不受影响，钱 / 额度补上后照常用。
四、给你的运营建议
| 建议 | 为什么 |
|---|---|
| 提前开低余额提醒 | 免得团队在不知情时整体断服 |
| 给核心子用户留足额度 | 防关键调用因额度封顶而失败 |
| 常看仪表盘消费趋势 | 预判钱多久花完、提前充值（见 账单与用量监控） |
| 把财务 / 运维邮箱加进通知 | 让相关同事同步收到提醒 |
仪表盘余额概览区域：
五、常见问题
Q：余额为 0 时调用报什么错？ A：调用会被拒，提示余额 / 额度不足。具体错误码以接口实际返回为准。充值后下一次请求即可恢复。
Q：某个子用户突然全部 Key 都调不通，别人正常，为什么？ A：多半是他的额度用尽了。名下所有 Key 共用一份额度，一空就全被拒。给他上调额度即可（组织池要有钱）。
Q：充值后多久恢复？ A：立即。充值 / 调额成功后，下一次请求就正常。
Q：欠费期间 Key 会失效吗？ A：不会。Key 本身保留，只是余额 / 额度不足时调用被拒，补上后照常用。
Q：低余额提醒在哪配？ A：「个人资料」页往下翻，「余额不足提醒」区。