# 解决 403 INSUFFICIENT_BALANCE 和 billing_error

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

网页版: https://bigmodel.io/zh-cn/docs/error-insufficient-balance · 更新于 2026-10-27

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

```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. [充值](https://bigmodel.io/purchase)。付款确认后余额立即更新。
2. 检查 [API Keys](https://bigmodel.io/keys) 里单个 Key 的额度：Key 自己的美元额度用完时返回的是 429 `API_KEY_QUOTA_EXHAUSTED`，不是 403。
3. 遇到 `spend_cap_reached`，等待重置，或在[余额与账单](https://bigmodel.io/purchase)里调高上限。
4. 余额为 0 时，仍然可以在每分钟限额内调用标价为 $0 的模型。见[试用额度与免费模型](https://bigmodel.io/zh-cn/docs/free-credits)。

## 常见问题排查

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

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

## 相关文档

- [计费与充值](https://bigmodel.io/zh-cn/docs/billing)
- [限额与速率](https://bigmodel.io/zh-cn/docs/rate-limits)
- [错误码与响应](https://bigmodel.io/zh-cn/docs/errors)