Token Plan 个人版的额度、购买、订阅和接入常见问题。
额度与限额
月限额是什么意思？
Token Plan 个人版采用月限额，无周额度使用限制，限额单位为 Credits。自订阅当日起向后延伸 30 天作为订阅周期，订阅周期内累计消耗达到套餐额度后暂停服务，需等待下一个订阅月后额度恢复。订阅月内未用完的额度不结转至下一周期。
例如：Standard 套餐的月额度为 45,000 Credits。9 月 10 日订阅，本订阅月为 9 月 10 日 ~ 10 月 10 日。9 月 20 日累计消耗达到 45,000 Credits 触顶，服务暂停；10 月 10 日下一个订阅月开始后，额度重置为 45,000 Credits，服务恢复。
各档位限额如下：
档位 | 每月限额 |
|---|---|
Lite 套餐 | 11,500 Credits |
Essential 套餐 | 25,500 Credits |
Standard 套餐 | 45,000 Credits |
Pro 套餐 | 180,000 Credits |
月额度是固定日期重置吗？
不是。额度按订阅月自动刷新：以订阅日为起点每 30 天为一个订阅月，每个订阅月开始时额度自动重置。重置时间取决于订阅日期，而非固定的日历日期（如每月 1 日）。
额度用完了怎么办？
限额用完后调用会被阻断，不会按量计费。恢复方式：
- 等待下一个订阅月额度重置。
- 升级套餐。
- 购买用量包，获得不受限额约束的额外额度。
开通 Token Plan 后为什么仍产生按量扣费？
开通 Token Plan 后仍看到按量扣费，通常是以下原因导致：
- 生效前调用：开通 Token Plan 之前发生的调用属于独立计费，无法被套餐抵扣。
- 配置错误：未使用 Token Plan 专属 API Key 和 Base URL（例如误用百炼通用 dashscope.aliyuncs.com 或 Coding Plan 的 Key），导致请求走按量计费通道。
- 模型不支持：调用了 Token Plan 白名单之外的模型（如 Qwen3-VL-Plus 及部分子型号）。
用量包和套餐是什么关系？需要先买套餐吗？
用量包是套餐的补充，提供不受套餐限额约束的额外 Credits，需先订阅有效套餐后才能购买，最多同时持有 5 个。
用量包的额度受套餐月限额影响吗？
不占用、不计入套餐月额度；套餐月额度用尽后，自动开始抵扣用量包额度。
用量包有效期多久？
用量包有效期为 1 个月，到期后未使用的额度自动作废，不支持退款。
Token Plan 的用量在哪里查看？
在百炼控制台的 Token Plan > 我的订阅 页面查看当前订阅的 Credits 额度及消耗情况；切换到 Harness 权益 页签查看 AgentStudio 工具的免费额度与折扣明细，详见 Harness 权益。
为什么账单/插件统计的 Credits 消耗与预期不一致？
Credits 消耗与账单或插件统计出现差异，常见原因：
- 功能模式影响：频繁切换工具调用或思考模式可能影响计费。
Token Plan 是否提供免费试用额度或赠送 Token？
Token Plan 套餐本身不提供试用额度，也不包含免费赠送的 Token 额度。百炼平台针对部分模型提供独立的免费额度，可以在控制台查询可用免费额度的模型列表。
如何减少 Token Plan 的 Credits 消耗？
- 压缩历史消息或新开对话窗口，避免长上下文累积消耗。
- 关闭思考模式（Thinking Mode）以降低推理开销。
- 非复杂任务场景下切换至轻量模型（如 qwen3.6-plus 替代 qwen3.7-max）。
- 利用缓存机制，缓存命中的 Token 计费价格低于正常 Input Token。
- 通过用量分析页面监控消耗明细，及时调整使用策略。
为什么第三方工具（如 Claude Code）显示的 Token 用量与百炼控制台统计不一致？
- 统计口径不同：第三方工具仅显示模型层面的输入输出 Token；百炼控制台统计包含完整消耗项。
- 隐藏消耗项：系统提示词、工具定义（Schema）、用户配置、项目约定、多轮对话历史累积、工具调用参数与返回结果、模型内部推理内容（reasoning）等，均会计入 Credits 消耗但不在第三方工具中显示。
- 模型单价影响：高价模型（如 qwen3.7-max）会导致相同 Token 数下 Credits 消耗更高。
- 优化建议：通过百炼控制台 Token Plan 订阅页的用量分析查看官方统计；使用
/compact压缩历史消息或/clear新开对话以减少上下文累积。
Harness 权益
Harness 权益的抵扣顺序是什么？
先抵扣服务本身免费额度，再抵扣 Token Plan 附赠权益额度，用尽后按折扣后付费。详见 Harness 权益。
Harness 调用使用哪个 API Key？
百炼 API Key（以 sk- 开头），不是 Token Plan 专属 API Key（以 sk-sp- 开头）。详见 Harness 权益。
Harness 调用会消耗套餐 Credits 吗？
不消耗。Harness 权益独立核算，超出按折扣后付费，不占用 Credits 或用量包。详见 Harness 权益。
在哪查看 Harness 权益的剩余额度？
在控制台我的订阅页面切换到Harness 权益页签查看。详见 Harness 权益。
加量包能否抵扣 Harness 服务的费用？
不能。用量包仅补充 Credits，Harness 权益独立核算。详见 Harness 权益。
接入报错
常见报错及解决方案
报错信息 | 可能原因 | 解决方案 |
|---|---|---|
401 InvalidApiKey: No API-key provided. | 请求头中未携带 API Key | 生成 API Key 并在工具中完成配置 |
401 InvalidApiKey: Invalid API-key provided. | 误用了按量计费的 API Key 或 Coding Plan 的 Key；订阅过期；Key 复制不完整 | 确认使用 Token Plan 个人版 API Key，确保完整且无空格 |
404 model_not_found: Model not exist. | 模型名称拼写错误或不在支持列表 | 确认模型名称区分大小写，与套餐支持的模型 ID 一致。 |
403 AccessDenied.Unpurchased: Access to model denied. | 调用的模型仅团队版支持，个人版不支持 | 改用个人版支持的模型，或使用 Token Plan 团队版 |
401 invalid access token or token expired | 误用了 Coding Plan 或其他计费模式的 Base URL | 使用 Token Plan 个人版 Base URL |
401 Incorrect API key provided | 误用了百炼通用 Base URL（dashscope.aliyuncs.com） | 使用 Token Plan 个人版 Base URL |
429 Requests rate limit exceeded | 短时间内请求过于密集 | 等待一分钟后重试，降低请求频率 |
429 insufficient_quota: Your token-plan quota has been exhausted. | 套餐月额度用尽 | 购买用量包补充额度，或等待下一个订阅月额度重置 |
400 invalid_parameter_error: Unexpected item type in content. | 向纯文本模型传入了图像等非文本内容 | 改用支持该模态的模型，或确认请求内容与模型能力匹配 |
502 Bad Gateway | 服务端偶发异常 | 稍后重试 |
Token Plan 用量显示为 0 或调用仍扣费/欠费怎么办？
- 用量显示为 0 通常是因为尚未产生实际消耗，或使用了非 Token Plan 专属 API Key。
- 调用仍扣余额或产生欠费，是因为配置了普通 API Key 而非套餐专属 Key。
并发与性能
最多支持多少个 Agent 并发？
并发能力与套餐档位相关：
档位 | 建议并发 |
|---|---|
Lite 套餐 | 可同时支持 1-2 个 Agent 并发运行 |
Essential 套餐 | 可同时支持 2-3 个 Agent 并发运行 |
Standard 套餐 | 可同时支持 3-4 个 Agent 并发运行 |
Pro 套餐 | 可同时支持 6-8 个 Agent 并发运行 |
高峰期响应会变慢吗？
高峰期可能出现排队等待。如需更稳定的吞吐，可升级到更高档位或使用团队版。
Token Plan 的限流阈值（TPM/RPM）是多少？能否提升？
限流阈值会根据整体负载动态调整以保障服务稳定性。套餐限流额度不支持提升。
优化建议：精简上下文、降低任务复杂度以减少单次输入 Token 数量；遇到限流时等待约 1 分钟后重试。
使用规则
"禁止 API 生产自动化调用"具体是什么意思？
Token Plan 个人版仅供个人通过官方指定工具（如 Cursor、Claude Code、Windsurf 等）进行交互式开发。不允许将 API Key 用于生产环境的自动化服务、批量脚本或后台定时任务等非交互场景。
多人共用一个账号可以吗？
不可以。Token Plan 个人版限单人使用，不允许多人共用同一账号或 API Key。如需多人协作，请使用 Token Plan 团队版。
可以在多台设备上使用同一个 API Key 吗？
可以。Token Plan 个人版每个订阅对应一个专属 API Key，生成后请立即复制并妥善保存。您可以将同一个 API Key 配置到多台设备（如家庭电脑和公司电脑）上使用，无需为每台设备重新生成。
购买与订阅
RAM 用户可以使用 Token Plan 吗？
可以，需由主账号完成以下授权：
- 在 RAM 控制台为该 RAM 用户授予
AliyunTokenPlanReadOnlyAccess（只读）或AliyunTokenPlanFullAccess（管理）系统策略，同时授予AliyunBSSReadOnlyAccess系统策略。 - 在百炼控制台账号管理页面，为该 RAM 用户分配管理员或订阅套餐权限。
可以升配吗？升配后额度怎么算？
支持从低档位升级到更高档位。升级不重置当前订阅周期：按剩余天数补缴差价，并按新档位与原档位的月额度差折算发放当前周期新增 Credits，自下一个订阅月起按新档位月额度计量，折算公式详见概述·升级。
可以降配吗？
不支持降配。如需更换为更低档位，可在订阅到期后重新购买。
自动续费怎么取消？
登录百炼控制台 Token Plan 页面，在订阅管理中关闭自动续费。
如何查看 Token Plan 套餐的生效时间和剩余天数？
- 生效时间查看路径：登录百炼控制台的 Token Plan 页面查看套餐生效时间。
- 剩余天数显示逻辑：控制台显示的剩余天数为向下取整后的完整 24 小时周期数，实际有效期以具体结束时间戳为准（例如剩余 22 天 20 小时会显示为 22 天），属正常显示逻辑。