Token Plan 个人版的额度、购买、订阅和接入常见问题。
额度与限额
5 小时/7 天限额是什么意思？
Token Plan 个人版采用每 5 小时滚动窗口和每 7 天固定窗口双重限额，限额单位为 Credits。任一窗口累计消耗达到限额后暂停服务，需等待对应窗口结束后额度重置。窗口期内未用完的额度不结转至下一周期。其中每 5 小时限额当前限时取消，暂不限制。
例如：Standard 套餐的 7 天限额为 10,000 Credits。您在 7 月 20 日首次调用，系统开启窗口（7 月 20 日 ~ 7 月 27 日）。7 月 20 日消耗 4,000 Credits，7 月 22 日消耗 6,000 Credits，累计 10,000 Credits 触顶暂停。需等到 7 月 27 日窗口结束，额度重置为 10,000 Credits，服务恢复。
各档位限额如下：
| 档位 | 5 小时限额 | 7 天限额 |
|---|---|---|
| Lite 套餐 | 2,500 Credits | |
| Standard 套餐 | 10,000 Credits | |
| Pro 套餐 | 40,000 Credits |
7 天限额是固定日期重置吗？
不是。7 天限额采用固定窗口机制，自首次调用起计时 7 天，到期后额度重置。重置时间取决于您首次调用的时间，而非固定的日历日期（如每周一）。
额度用完了怎么办？
限额用完后调用会被阻断，不会按量计费。恢复方式：
- 使用限额重置权益，立即刷新恢复额度。
- 等待额度释放。
- 升级套餐。
- 购买加油包，获得不受限额约束的额外额度。
加油包和套餐是什么关系？需要先买套餐吗？
加油包是套餐的补充，提供不受套餐限额约束的额外 Credits，需先订阅有效套餐后才能购买，最多同时持有 5 个。
加油包的额度有窗口限制吗？
没有。加油包额度不受套餐的 5 小时和 7 天窗口限额约束，购买后即可使用。
加油包有效期多久？在哪里购买？
加油包有效期为 1 个月，到期后未使用的额度自动作废，不支持退款。购买入口在 Token Plan 个人版管理页面。
Token Plan 的用量在哪里查看？
在 千问AI平台控制台的 Token Plan > 我的订阅 页面查看当前订阅的 Credits 额度及消耗情况。
接入报错
常见报错及解决方案
| 报错信息 | 可能原因 | 解决方案 |
|---|---|---|
| 401 InvalidApiKey: No API-key provided. | 请求头中未携带 API Key | 生成 API Key 并在工具中完成配置 |
| 401 InvalidApiKey: Invalid API-key provided. | 误用了按量计费的 API Key；订阅过期；Key 复制不完整 | 确认使用 Token Plan 个人版专属 API Key，确保完整且无空格 |
| 404 model 'xxx' not found or not supported | 模型名称拼写错误或不在支持列表 | 确认模型名称区分大小写，与套餐支持的模型 ID 一致。 |
| 401 invalid access token or token expired | 误用了其他计费模式的 Base URL | 使用 Token Plan 个人版专属 Base URL |
| 401 Incorrect API key provided | 误用了千问AI平台通用 Base URL（dashscope.aliyuncs.com） | 使用 Token Plan 个人版专属 Base URL |
| 429 Requests rate limit exceeded | 短时间内请求过于密集 | 等待一分钟后重试，降低请求频率 |
| 429 Allocated quota exceeded | 5 小时或 7 天限额用尽 | 使用限额重置权益、购买加油包或等待窗口释放额度 |
| 502 Bad Gateway（错误码 4028） | 纯文本模型无法处理图像请求，或模型内部异常 | 切换支持的模型重试，并确认请求内容与模型能力匹配 |
| 页面提示“服务不可用，请求已过期” | 控制台会话超时，或订阅过期后 Key 失效 | 刷新页面或重新登录；若曾过期中断后重新订阅，需重新获取并替换 API Key |
并发与性能
最多支持多少个 Agent 并发？
并发能力与套餐档位相关：
| 档位 | 建议并发 |
|---|---|
| Lite 套餐 | 可同时支持 1-2 个 Agent 并发运行 |
| Standard 套餐 | 可同时支持 3-4 个 Agent 并发运行 |
| Pro 套餐 | 可同时支持 6-8 个 Agent 并发运行 |