# 计费、余额与充值

> BigModel.io 如何按 Token 以美元计费（含缓存读取、缓存写入和分组倍率），何时请求会被拦截，如何充值，以及在哪里查看每一笔扣费。

网页版: https://bigmodel.io/zh-cn/docs/billing · 更新于 2026-10-18

BigModel.io 账户余额以美元计。每个成功的请求按实际使用的 Token 从余额扣费：模型标价乘以分组倍率。套餐分组的 Key 则从套餐额度中扣除。

| | 位置 |
|---|---|
| 模型价格（每 100 万 Token） | [模型目录](https://bigmodel.io/zh-cn/models) 与 [价格](https://bigmodel.io/zh-cn/pricing) |
| 余额、充值、套餐和消费上限 | [余额与账单](https://bigmodel.io/purchase) |
| 订单 | [订单](https://bigmodel.io/orders) |
| 每个请求及其费用 | [用量](https://bigmodel.io/usage) |

## 单个请求如何计价

每个模型页面列出四种价格（每 100 万 Token）：输入、输出、缓存读取、缓存写入。一个请求的费用为：

```text
cost   = input_tokens       × 输入价格
       + output_tokens      × 输出价格
       + cache_write_tokens × 缓存写入价格
       + cache_read_tokens  × 缓存读取价格
charge = cost × 倍率
```

- **倍率。** 由 Key 所在分组决定，专属费率可替代分组倍率。每个请求的实际扣费见[用量](https://bigmodel.io/usage)。
- **缓存 Token。** Chat Completions 中 `usage.prompt_tokens_details.cached_tokens` 按缓存读取价格计费，并从输入 Token 中扣除。Messages 中 `cache_control` 的写入按缓存写入价格计费（模型分别定价时按 5 分钟和 1 小时 TTL 区分），读取按缓存读取价格计费。见 [提示缓存](https://bigmodel.io/zh-cn/docs/prompt-caching)。
- **其他调整。** 部分模型定义了长上下文或服务等级价格，也有模型按次或按图片计费。以模型页面为准。
- **视频**按实测的输出 Token 计费，见下文“视频计费”。

示例（价格为虚构）：模型输入 $0.50、输出 $2.00（每 100 万 Token），分组倍率 1.0，请求使用 10,000 个输入 Token、2,000 个输出 Token，费用为 10,000 × 0.50 / 1M + 2,000 × 2.00 / 1M = $0.005 + $0.004 = **$0.009**。

## 失败的请求不扣费

失败或被拒绝的请求（认证错误、触发限额、上游错误等）不扣费。使用 OpenRouter 风格的 `models` 备选数组时，只对成功的那一次尝试扣费。见 [从 OpenRouter 迁移](https://bigmodel.io/zh-cn/docs/migrate-from-openrouter)。

## 什么时候请求会被拦截

调用付费模型时，只有余额**大于 0** 请求才会被接受。已经在运行的长请求结算后可能让余额略微变为负数；之后调用付费模型会返回 403，直到充值。`GET /v1/models` 等其他接口在余额为 0 时同样返回 403 `INSUFFICIENT_BALANCE`。标价 $0 的模型在生成类接口上仍可调用，见 [试用额度与免费模型](https://bigmodel.io/zh-cn/docs/free-credits)。

## 消费上限

有两种上限可以把消费控制在余额以内：

- **账户消费上限。** 在 [余额与账单](https://bigmodel.io/purchase) 中可以设置每周和每月的美元上限，限制余额的消费。每周从周一 00:00（UTC）开始，每月从 1 日 00:00（UTC）开始。达到上限后，请求返回 402 `spend_cap_reached`，`Retry-After` 指向重置时间；标价 $0 的模型仍可使用。想提前继续使用，可以取消或调高上限。
- **按 Key 限额。** 给每个 Key 设置额度或 5 小时 / 1 天 / 7 天消费窗口。见 [按 Key 限额与预算](https://bigmodel.io/zh-cn/docs/key-limits)。

注册即赠送试用额度，金额以控制台显示为准。见 [试用额度与免费模型](https://bigmodel.io/zh-cn/docs/free-credits)。

## 充值

1. 在控制台打开 [余额与账单](https://bigmodel.io/purchase)。
2. 选择金额，余额以美元入账。
3. 选择支付方式。可用方式以结账页为准，例如支付宝和 USDT（TRC20、ERC20 或 BEP20）。
4. 完成支付，等待订单完成。订单会显示在 [订单](https://bigmodel.io/orders) 中。

支付币种可能与美元余额不同，手续费（如有）会在支付前的结账页显示。

## 套餐与余额

如有套餐（订阅），会显示在控制台 [余额与账单](https://bigmodel.io/purchase) 页面，可购买的套餐和价格以该页面为准。每个套餐有有效期、包含的模型、各周期的美元限额和单独的倍率。套餐分组的 Key 从套餐及其限额中扣除；套餐之外的用量从余额扣费。套餐限额用完后，请求返回 429 `USAGE_LIMIT_EXCEEDED`。套餐不会自动续费。

## 退款

未使用的套餐可在购买后 24 小时内退款。USDT 支付不可退款，赠送额度没有现金价值。完整条款见 [退款政策](https://bigmodel.io/zh-cn/legal/refund-policy)。

## 查看每一笔扣费

[用量](https://bigmodel.io/usage) 页面逐条列出请求的 API Key、模型、端点、流式或非流式、计费方式、Token（悬停查看输入、输出、缓存创建 5m / 1h、缓存读取）、实际费用（原价划线显示）、首 Token 时间和耗时。可按 Key、模型和日期范围筛选，并导出 CSV。

单个 Key 可以用 `GET /v1/usage` 查看今日和累计的请求数、Token、费用，以及余额或额度：

```bash
curl https://bigmodel.io/v1/usage \
  -H "Authorization: Bearer $BIGMODEL_API_KEY"
```

## 图片、视频与音频计费

多模态模型按张、按输出秒数、按字符或按次计价，单价见各模型页面。提交任务时会按估价占用余额，任务成功后记账并显示在「日志」里；失败和取消的任务不收费。套餐 Key 只覆盖文本模型，多模态需要按量付费的 Key。在请求里加 `"dry_run": true` 可以只报价不生成。

## 常见问题排查

**刚充值仍然返回 403 `INSUFFICIENT_BALANCE`。** 在 [订单](https://bigmodel.io/orders) 中确认订单已完成，并检查之前的请求是否让余额变成了负数。

**扣费比标价高。** 检查 Key 的分组倍率，以及用量提示里是否有缓存写入 Token。

**429 `USAGE_LIMIT_EXCEEDED`。** 套餐的每日、每周或每月限额已用完。等待下一个周期，或换用从余额扣费的分组的 Key。

**429 `API_KEY_QUOTA_EXHAUSTED`。** 即使余额充足，这个 Key 自身的额度也已用完。在 [API Keys](https://bigmodel.io/keys) 中提高或重置额度。

**402 `spend_cap_reached`。** 账户的每周或每月消费上限已达到。等待 `Retry-After` 所示的重置时间，或在 [余额与账单](https://bigmodel.io/purchase) 中调整上限。

## 相关文档

- [试用额度与免费模型](https://bigmodel.io/zh-cn/docs/free-credits)
- [限额与速率](https://bigmodel.io/zh-cn/docs/rate-limits)
- [退款政策](https://bigmodel.io/zh-cn/legal/refund-policy)
- [价格](https://bigmodel.io/zh-cn/pricing)