Token Plan 各版本、购买与订阅、退订与退款、使用限制及接入的常见问题解答。
产品与版本
个人版和团队版有什么区别?
个人版面向个人开发者,按套餐档位订阅。团队版面向团队和企业,按席位订阅,提供席位管理、成员用量分析和 SSO 接入。两个版本在额度机制、数据安全和高峰期性能方面也存在差异。完整对比参见个人版订阅与权益和团队版订阅与权益。
可以同时购买个人版和团队版吗?额度是分开计算还是共享?
可以。同一阿里云账号可同时持有个人版和团队版。两者独立计费,额度不共享。
个人版可以升级或转换为团队版席位吗?
不可以。个人版和团队版是独立产品,额度不共享,个人版无法直接升级或转换为团队版席位。如需使用团队版,请单独订阅。个人版暂不支持退订,可在订阅到期后停止续费。
团队版 API Key 可以用于个人版吗?
不可以。个人版和团队版各自生成独立的 API Key,不能混用。系统会根据 API Key 自动识别对应的套餐。
已有个人版,再购买团队版会冲突吗?
不会。两者可同时持有,独立计费。系统会根据 API Key 自动匹配对应套餐。
Token Plan 支持哪些模型?
Token Plan 支持千问、万相、DeepSeek、月之暗面、智谱 AI、MiniMax 和 HappyHorse 模型。个人版和团队版支持的模型范围不同。完整列表参见个人版和团队版支持的模型。
Token Plan 支持 Cursor、Claude Code、Cline 等第三方工具吗?
支持。Token Plan 兼容 OpenAI 和 Anthropic 协议,任何支持自定义 Base URL 和 API Key 的工具均可接入。配置方法参见快速开始。
什么是模型内置工具?
模型内置工具是模型提供的能力,包括联网搜索、文搜图、图搜图、网页抓取和代码解释器。通过 Responses API 调用模型时会自动触发,并从 Credits 中抵扣。个人版和团队版均支持。详情参见模型内置工具。
Token Plan 是否提供试用额度或免费 Token?
Token Plan 本身不提供试用额度或免费 Token。百炼针对部分模型提供独立的免费额度;可在控制台查看有可用免费额度的模型列表。
购买与订阅
RAM 用户可以使用 Token Plan 吗?
可以。RAM 用户需要主账号授予 Token Plan 权限和费用中心权限:费用中心策略为个人版 AliyunBSSReadOnlyAccess、团队版 AliyunBSSFullAccess。完整授权步骤和权限对比参见权限与使用规范 · RAM 用户授权。
RAM 授权和席位分配是两个独立概念:RAM 授权决定谁可以管理订阅;席位分配决定谁可以使用模型。团队版成员仍需在团队管理中被分配席位后,才能获取 API Key。
可以升级吗?升级后额度如何计算?
支持从低档位升级到更高档位。升级不会重置当前订阅周期:按剩余天数支付按比例折算的差价,当前周期的新增 Credits 按新旧档位的月额度差折算。新档位月额度自下一个订阅月起适用。
公式和示例参见用量与额度 · 升级额度计算。
可以降配吗?
不支持降配。如需切换到更低档位或席位类型,请在订阅到期后重新购买或重新订阅。详情参见个人版 · 其他和团队版 · 注意事项。
如何取消自动续费?
- 个人版:登录 百炼控制台 Token Plan 页面,在订阅管理中关闭自动续费。
- 团队版:登录费用中心 > 续费管理,找到 Token Plan 团队版订单,关闭自动续费。
续费后需要重新配置 API Key 吗?
不需要。续费、订阅到期后重新购买、退订席位后重新购买,均不会变更已分配席位的 API Key。订阅到期或退订期间 API Key 暂时不可用,续费或重新购买成功后恢复可用。
如何查看套餐的生效时间和剩余天数?
- 生效时间:登录百炼控制台,查看 Token Plan 页面。
- 剩余天数:控制台显示的剩余天数按完整 24 小时周期向下取整。例如剩余 22 天 20 小时显示为 22 天;实际有效期以结束时间为准。
Token Plan 支持学生代金券吗?
不支持。学生代金券仅适用于活动页面指定的产品,不能用于购买 Token Plan。
退订与退款
个人版可以退订吗?
个人版暂不支持退订。可在订阅到期后停止续费。
团队版席位可以退订吗?
可以,支持按席位退订。已有用量消耗的席位不可退订。退款将原路退回至支付账户,预计 1-3 个工作日到账。操作参见团队版 · 退订席位。
使用限制
“禁止生产环境 API 自动化调用”是什么意思?
Token Plan 个人版仅限通过官方指定工具(如 Cursor、Claude Code、Windsurf)进行个人交互式开发。不允许将 API Key 用于生产环境的自动化服务、批量脚本或定时后台任务。
团队成员可以查看团队用量吗?
不可以。团队成员无法查看团队订阅、席位额度或共享用量包余额,需由所有者或管理员查看。详情参见团队管理 · 角色与权限。
数据会用于训练模型吗?
个人版的数据使用遵循服务协议;团队版不会使用对话数据训练模型。详情参见权限与使用规范 · 数据使用策略。
多人可以共用一个账号吗?
不可以。Token Plan 个人版仅限单人使用,不允许多人共用同一账号或 API Key。多人协作请使用 Token Plan 团队版。
可以在多台设备上使用同一个 API Key 吗?
可以。同一个 API Key 可配置到本人拥有的多台设备,但仅限本人使用。重置 API Key 会使旧 Key 立即失效,届时需在全部设备上更新为新 Key。仅在 Key 泄露时重置。
支持多少个并发 Agent?
个人版并发能力取决于套餐档位:
| 档位 | 建议并发 |
|---|---|
| Lite | 1-2 个 Agent |
| Essential | 2-3 个 Agent |
| Standard | 3-4 个 Agent |
| Pro | 6-8 个 Agent |
高峰期响应会变慢吗?
个人版在高峰期可能排队。如需更稳定的吞吐,可升级到更高档位或使用团队版。团队版采用多租户隔离架构,高峰期不排队。
限流阈值(TPM/RPM)是多少?可以提升吗?
限流阈值根据整体负载动态调整,以保障服务稳定。套餐限流额度不支持提升。如果被限流,请精简上下文、降低任务复杂度,等待约 1 分钟后重试。
团队版有并发限制吗?
有。平台会根据整体资源负载动态调整并发上限。达到并发限制时,请等待片刻后重试。
接入与报错
先区分四类场景
| 症状 | 原因 | 处理方式 |
|---|---|---|
| 429 insufficient_quota | 套餐额度或用量包额度用尽 | 等待重置、升级,或购买用量包或共享用量包 |
| 429 Requests rate limit exceeded | 短时间内请求过于集中 | 等待约 1 分钟后重试,并降低请求频率 |
| 并发限制 | 同时运行的 Agent 数量超过档位建议值 | 减少同时运行的 Agent 数量,或升级到更高档位 |
| 401、403、404 | API Key、Base URL 或模型配置错误 | 检查 Key 前缀、Base URL 和模型 ID |
排查顺序
- 确认 API Key 以
sk-sp-开头,并与 Token Plan Base URL 搭配使用。 - 确认模型 ID 在个人版和团队版支持的模型中,且适用于当前版本。
- 在控制台的我的订阅和用量分析页面检查额度是否用尽。
- 检查错误是
insufficient_quota、Requests rate limit exceeded还是认证错误。
常见报错
| 报错信息 | 可能原因 | 解决方案 |
|---|---|---|
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 一致 |
404 model 'xxx' not found or not supported | 模型名称拼写错误或不在支持列表 | 确认模型名称区分大小写,并与套餐支持的模型 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-intl.aliyuncs.com) | 使用 Token Plan Base URL |
400 Range of input length should be [1, xxx] | 输入内容超过模型最大上下文长度 | 新建会话清空历史,或使用工具的上下文压缩命令 |
400 invalid_parameter_error: Unexpected item type in content. | 向纯文本模型传入了图片等非文本内容 | 切换到支持该模态的模型,或确认请求内容与模型能力匹配 |
调用图片或视频生成模型时出现 400 错误 | 图片和视频生成模型使用单独的端点,不能通过文本模型 Base URL 直接调用 | 通过工具的 Skill、Slash Command 或 Agent 扩展机制接入 |
429 Requests rate limit exceeded | 短时间内请求过于集中;多个并行 Agent 也可能触发并发限制 | 等待约 1 分钟后重试,并降低请求频率和并发数 |
429 insufficient_quota: Your token-plan quota has been exhausted. | 套餐额度或用量包额度用尽 | 购买用量包、升级套餐,或等待下一个订阅月重置额度 |
502 Bad Gateway | 服务端偶发错误 | 稍后重试 |
额度用尽
429 insufficient_quota 响应表示额度用尽。抵扣顺序和恢复方式参见用量与额度 · 额度用尽与恢复。
限流与并发
429 Requests rate limit exceeded 响应表示限流,而非额度用尽。限流阈值会根据整体负载动态调整,套餐限流额度不支持提升。请等待约 1 分钟后重试、精简上下文、降低并发数或降低请求频率。团队版也有并发限制。
认证与配置
Token Plan、Coding Plan 和按量计费的 API Key 与 Base URL 相互隔离,必须成对使用:
- Token Plan:以
sk-sp-开头的 API Key + Token Plan Base URL。 - Coding Plan:Coding Plan API Key +
https://coding-intl.dashscope.aliyuncs.com/v1。 - 按量计费:百炼 API Key(以
sk-开头)+https://dashscope-intl.aliyuncs.com/compatible-mode/v1。