# 按量包说明

按量包是一次性购买的**总额度**：买下后在有效期内使用，用完为止，不像个人套餐那样每天重置。适合阶段性使用、不想按月订阅的场景。选哪种方案见 [如何选方案](/docs/getting-started/choose-a-plan)，在 [qcode.cc/pay-as-you-go](https://qcode.cc/pay-as-you-go) 购买。

## 四个包

| 包 | 价格 | 额度 | 有效期 |
|---|---|---|---|
| 周包 | ¥25 / $4 | $30 | 7 天 |
| 月包 | ¥60 / $9 | $80 | 30 天 |
| 双月包 | ¥120 / $18 | $180 | 60 天 |
| 季包 | ¥200 / $30 | $330 | 90 天 |

人民币充值最低 ¥100（按量包 ¥25 起，剩余余额可续买或买套餐）；美元最低 $1。

## 基本规则

- **一账号一把按量包 Key**：你的账号下只有一把按量包 Key，续买都落在这一把上。
- **并发 5**：同一把 Key 同时最多 5 个请求。
- **按量包 Key 不能买加油包**：额度用完直接续买。
- **模型与个人套餐一致**：能调用的模型相同，按 token 计费，各模型单价见 [qcode.cc/models](https://qcode.cc/models)。
- **Key 用法不变**：拿到的 `cr_` 开头的 Key 填进工具的方式与其他方案完全相同，见 [控制台使用指南](/docs/reference/dashboard-guide)。

## 续买：额度累加，到期日取较晚者

续买时，新包的额度会**累加**到当前剩余额度上；到期日取「当前到期日」与「今天 + 包天数」中**较晚**的那个。

**算例 1：未过期**。你的月包还剩 $12，到期前续买一个月包（$80）：剩余 $12 + 月包 $80 = $92，到期日取「当前到期日」与「今天 + 30 天」较晚者。

**算例 2：已过期**。按量包过期后，剩余额度作废。这时续买一个月包，续买后的额度 = 新包额度（$80），**同一把 Key 恢复可用**，不会换新 Key。

## 谁能买

- **名下有有效个人套餐时不能买按量包。** 个人套餐的日额度不够用时，请买加油包（加油包按北京时间次日凌晨 2 点重置）。
- 尊享版同样算有效个人套餐，期间不能买按量包。尊享版的额度是每月额度，不按天重置，也不能买加油包；用完时的处理见 [常见问题](/docs/reference/faq) 中「已达到总费用限制」一问，或联系客服。
- 已经有按量包、之后又买了个人套餐的：**按量包照常使用到到期**，不受影响。

## 额度用完与到期

- **额度用完**：返回 HTTP 402，`error.type` 为 `insufficient_quota`，`code` 为 `total_cost_limit_exceeded`。续买即可继续使用。详见 [错误码参考](/docs/reference/errors#402-quota-exhausted)。提示里 `($N)` 这样的金额是这把 Key 的**累计上限**，不是剩余额度；续买累加后这个数会变大，这是正常的。
- **Key 过期**：返回 HTTP 401（`API key has expired`）。续买即恢复，通过海外节点访问时最多约 5 分钟后生效。

## 不退款

按量包**不退款**，过期后剩余额度作废。不确定要买多长时间的话，可以先买周包。

## 常见问题

### 按量包和个人套餐有什么区别？

个人套餐是日额度，北京时间 0 点重置，适合每天使用；按量包是有效期内的总额度，用完为止，适合阶段性使用。四种方案的完整对照见 [如何选方案](/docs/getting-started/choose-a-plan)。

### 我已经有个人套餐，还能买按量包吗？

不能。名下有有效个人套餐时不能买按量包；个人套餐的日额度不够用时买加油包。先买了按量包、之后又买个人套餐的，按量包照常使用到到期。

### 续买后到期日怎么算？

额度累加，到期日取「当前到期日」与「今天 + 包天数」中较晚的那个。例如月包还剩 $12 时再买月包（$80），额度变成 $92。

### 按量包过期了，剩下的额度还在吗？

不在。过期后剩余额度作废；续买后额度等于新包的额度，原来的 Key 恢复可用。

### 返回 402 `total_cost_limit_exceeded` 是什么意思？

按量包的总额度用完了，续买即可。报错里括号中的金额是累计上限，不是剩余额度。

### 可以退款吗？

不可以，按量包不退款。