阿里云Token Plan使用指南：获取API Key和Base URL，在Claude、Cursor、Codex及Qoder等AI工具调用，Token Plan买了却用不起来？多半是API Key和Base URL填错了。Token Plan、Coding Plan和按量付费这三套体系的接入凭证完全隔离，必须配套使用。本文阿小云把接入步骤和避坑要点一次性说清楚。使用TokenPlan之前需要先订阅 👉️ 阿里云百炼Token Plan官网订阅 如下图：
一、接入前先确认：你的工具支持自定义Base URL吗？
Token Plan通过专属Base URL来调用，不是随便什么工具都能接入。你的AI工具必须支持自定义服务端点（Custom Base URL），这是硬性前提。
目前主流支持的工具包括：Claude Code、Cursor、Qwen Code、Codex、Qoder、Qoder CN、OpenClaw等。像Dify、n8n、Coze这类工作流平台，以及Postman这类API测试工具，是不支持接入Token Plan的。
简单说：能填自定义接口地址的AI编程工具，才能用Token Plan。
二、获取专属API Key和Base URL
API Key：认准 sk-sp- 前缀
Token Plan的API Key以 sk-sp- 开头，和按量付费的 sk-、Coding Plan的 sk-ws- 都不一样。在百炼控制台的Token Plan管理页面，分配席位后为成员生成API Key。
重要提醒：API Key只在创建或重置时完整显示一次，之后控制台只显示脱敏信息。生成时立刻复制保存，关掉页面就看不到了。
Base URL：Token Plan专用地址
Token Plan团队版的Base URL是：
https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1
这个地址和按量付费的 https://dashscope.aliyuncs.com/compatible-mode/v1 完全不同，不能混用。
三、三套体系的凭证必须严格对应
这是最容易出错的地方。Token Plan、Coding Plan、按量付费的API Key和Base URL是完全隔离的三套体系，必须一一对应：
| 计费模式 | API Key前缀 | Base URL |
|---|---|---|
| Token Plan | sk-sp- |
https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1 |
| Coding Plan | sk-ws- |
https://coding.dashscope.aliyuncs.com/v1 |
| 按量付费 | sk- |
https://dashscope.aliyuncs.com/compatible-mode/v1 |
填错的后果：如果Token Plan的Key配了按量付费的地址，调用会走按量计费通道，产生意外扣费；反过来则直接返回401/403鉴权失败。
四、接入步骤（三步搞定）
第一步：订阅Token Plan套餐
在 🔥 百炼控制台订阅Token Plan，选择套餐档位和订阅周期。主账号和RAM账号都可以订阅。
第二步：获取API Key和Base URL
在Token Plan控制台的成员管理页面，为账号分配席位后生成API Key。复制以 sk-sp- 开头的完整密钥，同时记下Token Plan专用的Base URL。
第三步：配置到AI工具中
以OpenClaw为例，在配置文件中添加：
"models": {
"providers": {
"bailian-token-plan": {
"baseUrl": "https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1",
"apiKey": "sk-sp-你的密钥",
"api": "openai-completions"
}
}
}
以Hermes Agent为例，执行三条命令即可：
hermes config set model.provider custom
hermes config set model.base_url https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1
hermes config set model.api_key sk-sp-你的密钥
配置完成后发送一条测试消息验证，能正常返回就说明接入成功了。
五、Token Plan支持哪些模型？
Token Plan团队版覆盖千问、DeepSeek、Kimi、GLM、MiniMax等主流模型：
| 品牌 | 主要模型 |
|---|---|
| 千问 | qwen3.8-max、qwen3.7-max、qwen3.6-plus、qwen3.6-flash |
| DeepSeek | deepseek-v4-pro、deepseek-v4-flash、deepseek-v3.2 |
| 月之暗面 | kimi-k2.7-code、kimi-k2.6、kimi-k2.5 |
| 智谱 AI | glm-5.2、glm-5.1、glm-5 |
| MiniMax | MiniMax-M2.5 |
| 图像/视频 | qwen-image-2.0、wan2.7-image、happyhorse-1.1-t2v |
图像生成和视频生成模型需要通过AI工具的Skill或扩展机制接入，不是直接走标准对话接口。
六、几个容易踩的坑
坑一：地域不对，买了用不了。 Token Plan仅支持华北2（北京）地域。控制台地域不对，可能看不到已购套餐，或者调用不走套餐额度。
坑二：模型ID写错，调用报错。 Token Plan的模型ID需要精确匹配，比如 qwen3.6-plus 不能写成 qwen3.6plus 或 qwen-3.6-plus。
坑三：免费额度不通用。 开通百炼送的免费Tokens走的是按量付费通道，Token Plan的专属Key消耗不了这个免费额度。
坑四：API Key硬编码。 不要把 sk-sp- 密钥直接写在业务代码里，用环境变量或配置文件管理，防止泄露后被恶意调用耗尽Credits。
一句话总结：Token Plan接入的核心就是——专属Key配专属URL，三套体系别混用，工具支持自定义端点才能用。
