Token Plan 团队版常见问题汇总
接入与调用
如何在编程工具中使用图像生成模型？
图像生成模型使用独立的接口，无法通过文本模型的 Base URL 直接调用。需要通过工具的 Skill 或扩展机制接入，具体配置方法请参见各工具的接入文档中的接入图像生成模型章节。
常见报错及解决方案
| 报错信息 | 可能原因 | 解决方案 |
|---|---|---|
| 401 InvalidApiKey: No API-key provided. | 请求头中未携带 API Key（Authorization: Bearer 或 x-api-key 均未传）。 | 前往管理后台生成 API Key，并在工具中完成配置。 |
| 401 InvalidApiKey: Invalid API-key provided. | 1. 误用了千问云通用 API Key（sk-xxx 格式） 2. Token Plan 团队版订阅过期 3. API Key 复制不完整或包含空格 | 1. 确认使用的是 Token Plan 专属 API Key，确保完整且无空格。 2. 确认订阅是否过期。 3. 如仍报错，重置 API Key，重置后使用新 Key 配置。 |
| 404 model 'xxx' not found or not supported / 400 Model not exist. | 1. 模型名称拼写错误或大小写错误 2. 模型 ID 不在套餐支持列表中 | 1. 确认模型名称区分大小写，与套餐支持的模型 ID 一致。 2. 检查所选套餐是否包含该模型。 |
| 401 invalid access token or token expired | 误用了其他套餐的 Base URL | Anthropic 兼容端点：https://token-plan.cn-beijing.maas.aliyuncs.com/apps/anthropic；OpenAI 兼容端点：https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1 |
| 401 Incorrect API key provided | 误用了千问云通用 Base URL（dashscope.aliyuncs.com） | Anthropic 兼容端点：https://token-plan.cn-beijing.maas.aliyuncs.com/apps/anthropic；OpenAI 兼容端点：https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1 |
| 400 InvalidParameter: Range of input length should be [1, xxx] | 输入内容（含对话历史、代码上下文等）超出模型的最大上下文长度 | 新建会话清空历史，或使用工具自带的上下文压缩命令（如 Claude Code 的 /compact、Qwen Code 的 /clear）。也可切换上下文窗口更大的模型。 |
| 400 InvalidParameter: url error, please check url! | Base URL 路径与协议不匹配。例如把 OpenAI 兼容路径配在 Anthropic 端点上，或反之。 | 按工具实际使用的协议选择对应的端点：Anthropic 兼容协议（Claude Code 等）以 /apps/anthropic 结尾；OpenAI 兼容协议（Cursor、Qwen Code 等）以 /compatible-mode/v1 结尾。 |
| 400 invalid_parameter_error: The thinking_budget parameter must be a positive integer and not greater than xxxxx | 工具配置中的思维链长度（如 thinking_budget、budgetTokens）超过当前模型支持的上限。各模型上限不同，以报错中的数值为准。 | 将思维链长度调整为不超过报错提示的上限值，或在不支持思考模式的模型上移除该配置项。 |
| 400 data_inspection_failed: Input text data may contain inappropriate content. | 输入或输出命中平台内容安全策略。 | 修改输入内容后重新提交。如多次触发，调整提示词避免敏感话题。 |
| 429 API-Key Requests rate limit exceeded, please try again later. | 短时间内请求过于密集，触发模型调用限流。 | 等待一分钟后重试；如频繁触发请降低请求频率，并确认 API Key 未被他人共享使用。 |
| 429 Throttling.AllocationQuota / insufficient_quota: You exceeded your current quota | 套餐 Token 已用完，坐席额度和共享加油包均已耗尽。 | 可加购坐席（加购后需将新坐席分配给成员后再使用）、加购共享加油包，或等待下一计费周期额度自动重置。 |
| Connection error | Base URL 域名拼写错误或网络连接异常 | 检查 Base URL 域名拼写及网络连接。 |
产品功能相关
Token Plan 团队版的 API Key 能与其他套餐或普通 API 混用吗？
不能。Token Plan 团队版和千问云按量计费的 API Key 和 Base URL 互不相通，请勿混用。误用其他 API Key 不会抵扣 Token Plan 团队版的套餐额度。
能在多个工具中使用同一订阅吗？
可以。同一 API Key 可在全部兼容的 AI 编程和智能体工具中使用，额度共享消耗。每个成员持有独立的 API Key，不可共享给其他成员。
有哪些使用限制？
仅限在兼容的 AI 编程和智能体工具中交互式使用，不可用于自动化脚本或应用后端。违规使用可能导致订阅暂停或 API Key 封禁。
购买相关
能升级或降级套餐吗？
不支持。各坐席类型之间不支持升降级切换，如需更高额度，可购买共享加油包补充。
可以同时购买多个套餐吗？
每个千问云账号限购一个订阅，同一订阅下每种坐席类型均可购买多个。共享加油包可叠加购买。
可以单独购买共享加油包吗？
不可以。共享加油包是 Token Plan 团队版的附加商品，需先订阅 Token Plan 团队版坐席套餐后，才能购买共享加油包。
套餐是否支持退订？
Token Plan 团队版不支持退款。订阅前请参见使用细则了解详细信息。
千问云账号欠费是否影响 Token Plan 团队版的使用？
Token Plan 团队版为预付费订阅产品，只要套餐额度未用尽且订阅仍在有效期内，千问云账号欠费不影响 Token Plan 团队版的正常使用。
计量相关
订阅后为什么仍被按量扣费？
如果订阅 Token Plan 团队版后仍产生按量计费的扣费，通常有以下原因：
- 未正确配置专属凭据（最常见）：工具中使用了千问云通用 API Key（
sk-xxx格式）和通用 Base URL（不含token-plan），系统将请求识别为按量计费调用。请确保使用 Token Plan 团队版专属 API Key，且 Base URL 包含token-plan。 - 工具回退到通用凭据：若工具中同时保留了通用和专属两套配置，部分工具可能自动路由到通用凭据。建议移除通用 API 配置，仅保留专属配置。
- 客户端缓存未清理：更新凭据后需清理工具缓存并重启，确保工具使用新配置。
Credits 抵扣规则是什么？
Token Plan 团队版实际消耗取决于每次请求中输入 Token、缓存 Token 和输出 Token 的组合。优先从坐席额度抵扣，坐席额度用尽后从共享加油包抵扣，全部用尽后服务暂停至下一计费周期或购买共享加油包补充额度。
如何查看用量？
在 Token Plan 团队版页面可查看套餐和共享加油包的用量详情。
用量如何重置？
坐席额度在每个订阅月到期时重置，未用完的额度不累积到下月。共享加油包的额度同样按月重置。
超出限额之后怎么办？
坐席额度用尽后自动从共享加油包抵扣；全部额度用尽后服务暂停。可通过以下方式恢复：
- 购买共享加油包补充额度。
- 等待下一计费周期额度自动重置。
