HRouter

INSUFFICIENT_BALANCE 余额不足怎么解决

调用返回 403 和错误码 INSUFFICIENT_BALANCE,提示“账户余额不足,请充值后重试”,说明账户余额已经用完(小于或等于 0)。充值后通常立即恢复。如果你确认有余额却仍然报这个错,按下面的步骤排查。

先确认真的没余额

  1. 打开 充值页面,查看账户余额。
  2. 打开 使用记录,按时间范围查看最近的消耗,确认余额是怎么用完的。
  3. 如果是按订阅计费的分组,余额不是判断依据,要看订阅额度,见下文。

充值之后

  1. 按 充值与到账 完成支付。
  2. 在 我的订单 里确认订单状态已经完成,再看余额是否增加。
  3. 余额增加后,重新发起一次请求即可,不需要重新创建 Key,也不用改工具配置。

已付款但长时间没到账:先刷新订单和余额,保留订单编号和支付凭证后联系平台,不要重复付款。

有余额却仍然报错

可能原因 怎么确认
看的是别的账号 确认登录账号和 Key 属于同一个账号
Key 属于订阅类分组 余额不能用于订阅分组,要看订阅是否有效、额度是否用完,见 API 403 报错
页面数据没刷新 在 使用记录 点击刷新全部,再核对余额
Key 设置了额度上限 这类情况返回的是 429 API_KEY_QUOTA_EXHAUSTED,见 429 限流与额度

余额、订阅权益和 Key 的分组是三个不同的概念:有余额不等于所有分组都能用,Key 的额度上限也独立于账户余额。

如何避免

  • 给常用 Key 设置额度上限,避免某个工具或脚本一次性耗尽余额。额度上限的设置见 创建 API Key。
  • 定期在 使用记录 核对消耗,开启自动刷新可以实时观察。
  • 长任务(例如让 Codex、Claude Code 连续跑很久)开始前先确认余额充足,中途耗尽会导致任务中断。

相关阅读