GUIDE · 阿里云
Cherry Studio 接入阿里云百炼新人免费额度:添加 OpenAI 类型提供商(附免费额度不扣费要点)
Cherry Studio 是开源的 AI 桌面客户端。本文按阿里云百炼官方文档,把百炼按量计费(含新人免费额度)添加为一个 OpenAI 类型的提供商,并说明为什么有免费额度还可能被扣费。火山方舟、硅基流动的配置见本站《OpenAI 兼容接口通用教程》。
- 适用对象
- 想要一个桌面聊天客户端、刚领到百炼新人免费额度的新手
- 预计用时
- 约 5 分钟
- 最后核实
准备
- 已安装 Cherry Studio(下载页面)
- 阿里云百炼 API Key:在 API Key 页面 右上角选北京地域后创建并复制
步骤
创建百炼 API Key(地域选北京)
百炼文档说明:每个地域有独立的接入域名、API Key 和模型列表,不能跨地域混用。在 API Key 页面右上角选择地域,点 创建 API Key,归属业务空间保持「默认业务空间」、权限建议选「全部」,确定后点复制图标拿到 Key。
在 Cherry Studio 添加提供商
打开 Cherry Studio,点右上角设置,在 模型 栏点 添加,填写供应商名称(如「百炼」),提供商类型选 OpenAI。
填写 API 密钥和 API 地址
- API 密钥:粘贴百炼 API Key;
- API 地址:按量计费北京地域为
https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1(把{WorkspaceId}换成你的业务空间 ID)。百炼「获取与配置 API Key」文档也给出了北京地域通用地址https://dashscope.aliyuncs.com/compatible-mode/v1。
注意 Token Plan、Coding Plan 有各自专属的地址和 Key,用新人免费额度就用按量计费这一套。
添加模型并验证
在 模型 ID 填入要用的模型(如
qwen-plus,以百炼模型列表为准),点 添加。回到对话界面,选中这个模型随便问一句,正常返回就配置成功。硅基流动用户:直接选内置的「硅基流动」
Cherry Studio 内置了硅基流动:设置 → 模型服务 → 选择 硅基流动 → 填入 Key → 点 管理 把模型加入「我的模型」即可,详见本站《OpenAI 兼容接口通用教程》。
注意事项
- 免费额度只在北京地域生效:百炼文档明确,新人免费额度仅适用于华北2(北京)地域的模型,用其他地域的模型会产生费用。
- 额度按模型独立计算:每个模型有自己的免费额度,不能跨模型共享,A 模型用完了不会自动用 B 模型的额度。
- 控制台数据有延迟:免费额度数据每小时更新,控制台显示还有余量时,实际可能已经用完。
- 如果是 RAM 子账号,需要在业务空间管理里确保有模型调用权限。
常见问题
报错 The value of the enable_thinking parameter is restricted to True?
百炼文档说明:该模型只支持思考模式运行,在 Cherry Studio 里为这个模型开启思考模式即可。
有免费额度但产生了费用?
依次检查:API 地址是不是北京地域;用的模型是否还有自己的免费额度;控制台数据是否有一小时的延迟。百炼控制台可以查看产生费用的模型和调用记录。
相关优惠
信息来源
- 阿里云百炼 · Cherry Studiohelp.aliyun.com/zh/model-studio/cherry-studio
- 阿里云百炼 · 获取与配置 API Keyhelp.aliyun.com/zh/model-studio/get-api-key
- SiliconFlow · 在 Cherry Studio 中使用docs.siliconflow.cn/cn/usercases/use-siliconcloud-in-cherry-studio
最后核实日期:2026-10-09 · 政策可能随时调整,请以官方页面为准