解决 403 INSUFFICIENT_BALANCE 和 billing_error

BigModel.io 返回 403 INSUFFICIENT_BALANCE、billing_error，以及视频和消费上限返回 402 的原因，预付美元余额如何扣费，余额为 0 时如何继续调用免费模型。

本页目录
  1. 这是什么意思
  2. 怎么解决
  3. 常见问题排查
  4. 相关文档

余额不够支付请求时，会返回下面的错误：

json
{ "code": "INSUFFICIENT_BALANCE", "message": "Insufficient balance. Top up at https://bigmodel.io/purchase to continue.", "error": { "message": "Insufficient balance. Top up at https://bigmodel.io/purchase to continue.", "type": "permission_error", "code": "INSUFFICIENT_BALANCE" } }

#这是什么意思

BigModel.io 是预付费的：每个请求按模型标价从美元余额扣费。余额为 0 或以下时，付费模型返回 403。图片、视频和音频任务在余额不够支付预估费用加上未完成任务时，返回 402 insufficient_balance。失败的请求不扣费。

402 spend_cap_reached 是另一回事：你达到了自己设置的每周或每月消费上限。它带有 Retry-After 头，值是距离上限重置的秒数。

#怎么解决

  1. 充值。付款确认后余额立即更新。
  2. 检查 API Keys 里单个 Key 的额度：Key 自己的美元额度用完时返回的是 429 API_KEY_QUOTA_EXHAUSTED，不是 403。
  3. 遇到 spend_cap_reached，等待重置，或在余额与账单里调高上限。
  4. 余额为 0 时，仍然可以在每分钟限额内调用标价为 $0 的模型。见试用额度与免费模型。

#常见问题排查

控制台显示还有余额，请求却返回 403。 请求的预估费用（按 max_tokens 和仍在运行的请求计算）超过了剩余余额。调低 max_tokens、等正在运行的请求结束，或者充值。

套餐 Key 调用媒体模型返回 403 permission_error。 套餐 Key 不能使用图片、视频和音频模型，请使用按量付费的 Key。

#相关文档

更新于 · 以 Markdown 查看