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. | 误用了千问 AI 平台通用 API Key（sk-xxx 格式）；订阅过期；API Key 复制不完整或包含空格 | 确认使用的是 Token Plan 专属 API Key，确保完整且无空格。确认订阅是否过期。如仍报错，重置 API Key 后使用新 Key 配置。 |
| 404 model 'xxx' not found or not supported / 400 Model not exist. | 模型名称拼写错误或大小写错误；模型 ID 不在套餐支持列表中 | 确认模型名称区分大小写，与套餐支持的模型 ID 一致。检查所选套餐是否包含该模型。 |
| 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 | 误用了千问 AI 平台通用 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 InvalidParameter: Range of max_tokens should be [1, xxxx] | max_tokens 超出当前模型支持的最大输出 Token 数 | 将 max_tokens 调整为不超过报错信息中提示的上限值。 |
| 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 | 输入或输出命中平台内容安全策略 | 修改输入内容后重新提交。如多次触发，调整提示词避免敏感话题。 |
| 429 API-Key Requests rate limit exceeded | 短时间内请求过于密集，触发模型调用限流 | 等待一分钟后重试；如频繁触发请降低请求频率，并确认 API Key 未被他人共享使用。 |
| 429 Throttling.AllocationQuota / insufficient_quota | 套餐额度已用尽：席位额度和共享加油包均已耗尽。或触发模型调用限流：TPS/TPM 超过模型限流阈值，限流按主账号维度计算。 | 额度已用尽：购买共享加油包，或等待下一计费周期额度自动重置。触发限流：等待约一分钟后重试，采用平滑请求策略避免瞬时高峰。 |
| 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 封禁。
成员如何获取 API Key？
管理员在管理后台创建成员账号并分配席位后，为成员生成 API Key。成员无法自行生成，需联系管理员获取。详见团队管理。
回收席位、修改角色、移出组织有什么区别？
这三个操作都在成员管理页面执行，但作用范围不同：
- 回收席位：撤销成员的席位使用权并将席位释放回席位池。成员失去使用权，但仍留在组织中，可被重新分配席位。
- 修改角色：变更成员的权限（如管理员/普通成员），不影响席位分配和组织归属。
- 移出组织：将成员从团队完全移除，席位自动回收至席位池，成员从成员列表消失。
为什么 API Key 只能查看一次，丢失后如何处理？
为避免团队间 API Key 混用导致计费混乱，API Key 仅在首次生成或重置时显示，后续无法再次查看或复制。若 API Key 丢失，在成员管理页面找到对应成员，点击重置生成新 Key，原 Key 立即失效，需在工具中重新配置。
购买相关
可以同时购买多个套餐吗？
每个账号限购一个订阅，同一订阅下每种席位类型均可购买多个。共享加油包可叠加购买，单次最多 1000 个。
可以单独购买共享加油包吗？
不可以。共享加油包是 Token Plan 团队版的附加商品，需先订阅 Token Plan 团队版席位套餐后，才能购买共享加油包。
如何关闭或开启自动续费？
登录 Token Plan 管理页面，在订阅管理中关闭或开启自动续费。
账号欠费是否影响 Token Plan 团队版的使用？
Token Plan 团队版为预付费订阅产品，只要套餐额度未用尽且订阅仍在有效期内，账号欠费不影响 Token Plan 团队版的正常使用。
计量相关
Credits 抵扣规则是什么？
Token Plan 团队版实际消耗取决于每次请求中输入 Token、缓存 Token 和输出 Token 的组合。优先从席位额度抵扣，席位额度用尽后从共享加油包抵扣，全部用尽后服务暂停至下一计费周期或购买共享加油包补充额度。
如何查看用量？
在 Token Plan 管理页面可查看套餐和共享加油包的用量详情。管理员还可在管理后台的用量分析页面查看全部成员的消耗明细。
用量如何重置？
席位额度在每个订阅月到期时重置，未用完的额度不累积到下月。共享加油包额度购买后有效期为 1 个月，到期后需重新购买，不随席位额度按月重置。
超出限额之后怎么办？
席位额度用尽后自动从共享加油包抵扣；全部额度用尽后服务暂停。可通过以下方式恢复：
- 购买共享加油包补充额度。
- 等待下一计费周期额度自动重置。
续费后为什么 Credits 没有增加？
Token Plan 团队版的席位额度按订阅周期计算，每个订阅月到期时自动重置。续费仅延长订阅有效期或预定下一计费周期的额度，不会叠加补充至当前计费周期。
若当前周期额度已用尽且需立即恢复服务，可通过以下方式恢复：
- 购买共享加油包补充额度。
- 升级至更高规格的席位。
