Token Plan API Key 得先订阅 Token Plan,再在控制台成员管理里给成员分配席位、生成专属密钥(以 sk-sp- 开头)。密钥只在创建或重置时完整露一次脸,关掉弹窗就只剩脱敏内容,所以当场就得复制存好。下面把订阅、席位分配和密钥生成一步步讲清,顺带说清它和通用百炼 Key 为什么不能混用。
Token Plan 专属密钥的官方入口
Token Plan 的专属 Key 跟通用百炼 Key 不是一套东西,去哪拿要先分清:
- Token Plan 订阅页:在控制台内进入 Token Plan,选好席位类型和数量完成订阅,个人版和团队版都从这里进。
- 成员管理 / 管理平台:订阅之后在这里建成员账号、分配席位,再为成员生成专属 API Key。
别走错地方:通用百炼 Key 是在「API Key 管理」页建的,以 sk- 开头,走按量付费;Token Plan 专属 Key 以 sk-sp- 开头,只能在成员管理里给已经分到席位的成员生成。两套从入口起就分开了。
获取 Token Plan 专属密钥的步骤
- 进控制台 Token Plan 页面,挑套餐档位和订阅周期完成订阅;主账号和 RAM 账号都能订阅。
- 要用 RAM 子账号操作的,主账号得先在 RAM 控制台给这个子账号挂上 AliyunTokenPlanReadOnlyAccess(读)或 AliyunTokenPlanFullAccess(管)策略,再加一条 AliyunBSSReadOnlyAccess,最后到百炼控制台账号管理里给它分配管理员或订阅套餐权限。
- 在成员管理页给对应账号分配席位——这一步是硬前提,没分配席位之前生成不了密钥。
- 点该成员对应的「生成」建专属 API Key;密钥只在创建或重置时完整显示一次,弹窗一关就只剩 sk-sp-**** 这种脱敏样子,再也看不全,所以生成那一刻就复制保存好。
- 在同一页把套餐专属的 Base URL 一并记下,和 sk-sp- 密钥一起填进 AI 工具就能调了。
官方快速开始文档以团队版为例子。个人版路径更简单,在订阅页就能直接生成密钥;具体入口跟着控制台当前版本走就行。
Token Plan 密钥格式与配套接入地址
Token Plan 专属密钥以 sk-sp- 开头,和通用百炼密钥(sk- 开头)长得不一样。AI 工具支持哪种协议,就选对应的 Base URL:
| | |
|---|
| https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1 | openai / dashscope SDK,以及大多数编程与对话工具 |
| https://token-plan.cn-beijing.maas.aliyuncs.com/apps/anthropic | |
密钥本身没有强制过期一说,除非你主动删掉、重置,或者把账号移出业务空间。要在浏览器、手机这类不可信环境里用,可以改发最长 1800 秒的临时密钥顶上。
Token Plan 三种计费模式的密钥隔离规则
Token Plan、Coding Plan 和按量付费这三套密钥加 Base URL 完全隔离,必须成对用:
| | |
|---|
| | token-plan.cn-beijing.maas.aliyuncs.com |
| | https://coding.dashscope.aliyuncs.com/v1 |
| | https://dashscope.aliyuncs.com/compatible-mode/v1 |
混用的代价很直接:买了 Token Plan 却拿了通用 sk- 密钥,或者用了别的计费模式的 Base URL,调用会拐进按量计费通道凭空多出账单,要么直接甩你 401/403 鉴权失败。sk-sp- 密钥和 Token Plan 专属 Base URL 得绑在一起出现,拆开就出事。
Token Plan 密钥常见问题排查
| | |
|---|
| sk-sp- 密钥和 Base URL 没配对,或者错拿了通用 sk- 密钥 | 确认 sk-sp- 开头密钥配的是 Token Plan 专属 Base URL |
| 创建或重置后只露一次,之后脱敏成 sk-sp-**** | |
| | |
| 买了 Token Plan 却用了通用密钥或其他模式 Base URL | 统一换回 sk-sp- 密钥加 Token Plan 专属 Base URL |
Token Plan API Key 获取常见问题
Q:没订阅 Token Plan 能直接生成 sk-sp- 密钥吗?
A:不行。专属密钥建立在分配席位之上,得先订阅 Token Plan,再在成员管理给账号分配席位,才能生成。
Q:个人版和团队版拿密钥的方式一样吗?
A:团队版要管理员先分席位、成员登录后再生成专属密钥;个人版在订阅页就能直接生成,步骤更短。
Q:Token Plan 密钥能和通用百炼密钥混着用吗?
A:不能。前缀不同(sk-sp- 与 sk-),而且密钥和 Base URL 整套隔离,必须配套,混用会鉴权失败或走按量计费。
Q:密钥生成之后还能再看一眼完整的吗?
A:看不了。只在创建或重置时完整显示一次,之后控制台只留脱敏信息,丢了只能重置或新建。
Q:RAM 子账号能自己订阅和生成密钥吗?
A:订阅 RAM 账号能做,但得主账号先在 RAM 控制台授 Token Plan 与 BSS 的只读或管理策略,再到百炼控制台账号管理分配权限。
Q:Token Plan 支持哪些协议接入?
A:官方给的是 OpenAI 兼容和 Anthropic 兼容两套 Base URL,主流编程和对话工具按自己支持的协议挑一个就行。
Q:Base URL 到底填哪个域名才对?
A:以控制台「API Key 页面」实时显示的 Base URL 为准,目前官方文档给的是 token-plan.cn-beijing.maas.aliyuncs.com 那组地址。
Q:一个席位能让几个人共用一把密钥吗?
A:不合适也不被允许。许可协议写明套餐是订阅人专享的,每个席位对应一个独立成员,方便算用量和管权限。
Q:密钥会过期吗?
A:专属密钥没有强制失效时间,除非你删掉、重置,或者把账号移出业务空间;不可信环境就改用最长 1800 秒的临时密钥。
Token Plan API Key 的获取说到底就是「先订阅、再分席位、最后生成专属密钥」三步,密钥只露一次千万别等关了弹窗才想起来复制。想接着跟 Token Plan API Key 的接入细节和百炼模型更新,可以留意本站的 AI 工具栏目,有变动我们会同步补上。