阿里云Token Plan使用指南:获取API Key和Base URL,在Claude、Cursor、Codex及Qoder等AI工具调用

简介: 阿里云Token Plan接入指南:需使用专属`sk-sp-`开头API Key与北京地域Base URL(`https://token-plan.cn-beijing.maas.aliyuncs.com/...`),仅支持Claude、Cursor等可配自定义端点的AI工具。三套计费体系凭证严格隔离,填错将导致鉴权失败或意外扣费。

阿里云Token Plan使用指南:获取API Key和Base URL,在Claude、Cursor、Codex及Qoder等AI工具调用,Token Plan买了却用不起来?多半是API Key和Base URL填错了。Token Plan、Coding Plan和按量付费这三套体系的接入凭证完全隔离,必须配套使用。本文阿小云把接入步骤和避坑要点一次性说清楚。使用TokenPlan之前需要先订阅 👉️ 阿里云百炼Token Plan官网订阅 如下图:

阿里云百炼Token Plan官网订阅

一、接入前先确认:你的工具支持自定义Base URL吗?

Token Plan通过专属Base URL来调用,不是随便什么工具都能接入。你的AI工具必须支持自定义服务端点(Custom Base URL),这是硬性前提。

阿里云Token Plan支持的AI工具

目前主流支持的工具包括: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,三套体系别混用,工具支持自定义端点才能用。

相关文章
|
2月前
|
人工智能 测试技术 API
阿里云Token Plan怎么使用?先订阅Token Plan、然后获取API Key和Base URL,在AI工具中调用即可
阿里云Token Plan接入指南:需先订阅,再获取以`sk-sp-`开头的API Key和专属Base URL(如`token-plan.cn-beijing.maas.aliyuncs.com`),仅支持可配置自定义端点的AI工具(如Cursor、Qwen Code等)。三套计费体系凭证完全隔离,混用将导致鉴权失败或误扣费。
877 0
|
存储 安全 算法
一文搞懂PKI/CA
一文搞懂PKI/CA
4265 0
一文搞懂PKI/CA
|
域名解析 Ubuntu Linux
Docker 镜像基本操作
本文介绍 Docker 镜像最常用的三个基本操作 login、pull、push以及如何登录子账户。通过认识镜像的基本操作,您可以更熟练地使用容器镜像服务 ACR。
9325 0
Docker 镜像基本操作
|
人工智能 安全 Apache
QwenPaw:你的私人 AI 助理 —— 数据归你、记忆进化、多端触达的开源个人智能体
QwenPaw 是一款开源、本地优先的AI个人智能体(Apache 2.0),数据归属用户、记忆自主进化、支持钉钉/飞书/微信等多端触达。3行命令即可部署,内置Coding IDE、Persona人格、定时任务、MCP工具生态与多Agent协作,真正属于你的私有AI助理。
QwenPaw:你的私人 AI 助理 —— 数据归你、记忆进化、多端触达的开源个人智能体
|
2月前
|
存储 人工智能 IDE
阿里云千问办公、Qoder CN和Qoder Teams有什么区别?看完直接选!
阿里云三款AI产品定位清晰:千问办公(QwenWork)专注通用办公自动化,面向非技术岗;Qoder CN是国内合规版AI编码平台,支持IDE/CLI/办公全场景;Qoder Teams是Qoder CN的企业团队版,提供席位管理、共享知识库与用量审计。
1870 6
阿里云千问办公、Qoder CN和Qoder Teams有什么区别?看完直接选!
|
2月前
每日重置,限时返场!
「每日重置」限时返场!擅长处理超长自主任务与电脑操作的 Qoder 家族新成员。用户呼声已收到,明日揭晓,敬请期待!
346 0
|
2月前
|
人工智能 编解码 API
阿里云Token Plan是什么?百炼TokenPlan介绍、费用、API调用及问题解答FAQ
阿里云百炼Token Plan是面向AI开发者的统一计费订阅服务,以Credits为通用消耗单位,覆盖文本、图像、视频、语音及Harness工具,兼容OpenAI/Anthropic协议。支持个人版(7天滚动限额)与团队版(坐席制+月度额度),助力开发者降本增效、简化成本管理。在阿里云百炼官网:https://t.aliyun.com/U/fPVHqY 免费领取千万Tokens
286 0
|
2月前
|
人工智能 API 开发工具
阿里云百炼计费科普:按量、TokenPlan、CodingPlan 三种模式优缺点指南
阿里云百炼提供三种AI调用计费模式:按量付费(默认,用完700万免费Token后计费)、TokenPlan(39元/月,按Credits抵扣)和CodingPlan(200元/月,按调用次数限量抢购),支持Cursor、Qwen Code等主流AI工具接入。在阿里云百炼官网:https://t.aliyun.com/U/fPVHqY 免费领取千万Tokens
310 0
|
2月前
|
弹性计算
阿里云服务器ECS流量如何计费?不同地域流量收费价格表、计费规则及CDT免费220GB流量说明
阿里云ECS按流量计费,价格因地域而异:中国大陆多为0.8元/GB(青岛0.72元),中国香港1元/GB,海外低至0.5元/GB;含CDT免费220GB/月,超量阶梯计费。
520 0
|
2月前
|
云栖大会