Skip to main content

Token Plan 常见问题

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 按新旧档位的月额度差折算。新档位月额度自下一个订阅月起适用。 公式和示例参见用量与额度 · 升级额度计算。

可以降配吗?

不支持降配。如需切换到更低档位或席位类型,请在订阅到期后重新购买或重新订阅。详情参见个人版 · 其他和团队版 · 注意事项。

如何取消自动续费?

续费后需要重新配置 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?

个人版并发能力取决于套餐档位:
档位建议并发
Lite1-2 个 Agent
Essential2-3 个 Agent
Standard3-4 个 Agent
Pro6-8 个 Agent

高峰期响应会变慢吗?

个人版在高峰期可能排队。如需更稳定的吞吐,可升级到更高档位或使用团队版。团队版采用多租户隔离架构,高峰期不排队。

限流阈值(TPM/RPM)是多少?可以提升吗?

限流阈值根据整体负载动态调整,以保障服务稳定。套餐限流额度不支持提升。如果被限流,请精简上下文、降低任务复杂度,等待约 1 分钟后重试。

团队版有并发限制吗?

有。平台会根据整体资源负载动态调整并发上限。达到并发限制时,请等待片刻后重试。

接入与报错

先区分四类场景

症状原因处理方式
429 insufficient_quota套餐额度或用量包额度用尽等待重置、升级,或购买用量包或共享用量包
429 Requests rate limit exceeded短时间内请求过于集中等待约 1 分钟后重试,并降低请求频率
并发限制同时运行的 Agent 数量超过档位建议值减少同时运行的 Agent 数量,或升级到更高档位
401、403、404API Key、Base URL 或模型配置错误检查 Key 前缀、Base URL 和模型 ID

排查顺序

  1. 确认 API Key 以 sk-sp- 开头,并与 Token Plan Base URL 搭配使用。
  2. 确认模型 ID 在个人版和团队版支持的模型中,且适用于当前版本。
  3. 在控制台的我的订阅和用量分析页面检查额度是否用尽。
  4. 检查错误是 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。
Base URL 参见个人版快速开始 · 步骤二和团队版快速开始 · 步骤二。支持的模型参见个人版和团队版。

用量问题

关于额度如何计算、何时重置、用尽后怎么办、在哪里查看以及消耗异常的原因,请参见: