在 Cherry Studio 中使用阿里云百炼模型。
快速开始
- 1
获取 API Key
根据计费方案获取对应的 API Key:
- Token Plan 个人版:创建或查看 API Key
- Token Plan 团队版:分配坐席并获取 API Key
- 按量计费:百炼 API Key
- Coding Plan:Coding Plan API Key
- 2
配置模型
打开 Cherry Studio,点击右上角的设置按钮,在 模型 栏点击 添加,填写供应商名称(例如
百炼),提供商类型选择 OpenAI。按计费方案填写配置:Token Plan
配置项 值 API 地址 https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1API 密钥 Token Plan 个人版或团队版专属 API Key 模型 填写个人版或团队版支持的文本生成模型 按量计费
按实际调用量后付费。将
{WorkspaceId}替换为 Workspace ID,以下以华北2(北京)为例。配置项 值 API 地址 https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1API 密钥 百炼 API Key 模型 qwen3.8-max或qwen3.8-flash;可用模型见 OpenAI 兼容接口支持的模型Coding Plan
配置项 值 API 地址 https://coding.dashscope.aliyuncs.com/v1API 密钥 Coding Plan 专属 API Key 模型 qwen3.7-plus;可用模型见 Coding Plan 支持的模型 - 3
验证
在 模型 ID 填入模型,点击 添加。返回对话界面,选择刚添加的模型并发送任意消息,模型正常返回响应即配置成功。
错误码
配置过程中遇到报错,参考对应计费方案的常见问题文档:
- Token Plan:个人版常见问题 · 团队版常见问题
- 按量计费:错误码
- Coding Plan:Coding Plan 常见问题
常见问题
如何按量计费接入节省计划与资源包?
按量计费接入方式不变,使用百炼通用 API Key 和 Base URL。购买节省计划或资源包后自动生效,调用费用按抵扣顺序自动抵扣。详情参见节省计划与资源包。
调用时报错 401 Unauthorized
可能原因:
- API Key 与所选计费方案不匹配。Token Plan、按量计费和 Coding Plan 的 API Key 互不通用。
- 按量计费的 API Key 与 API 地址不在同一地域。
使用对应方案的专属 API Key,并确认按量计费的 API Key 与地域匹配。
RAM 子账号调用模型时报错无权限
RAM 子账号需要拥有模型的调用权限。参见业务空间管理。
报错 The value of the enable_thinking parameter is restricted to True
原因:该模型仅支持在思考模式下运行,但调用时未开启思考模式。
解决方案:在客户端中开启思考模式。
接入按量计费时,有免费额度但产生了费用
可能的原因:
- 地域不匹配:免费额度仅适用于华北2(北京)地域的模型。使用其他地域的模型会产生费用。请检查API 地址是否与目标地域匹配,详情请参见新人免费额度。
- 额度按模型独立计算:各模型的免费额度相互独立,不可跨模型共享。
- 数据更新延迟:控制台显示的免费额度数据每小时更新。即使控制台显示仍有余量,实际额度也可能已耗尽。
可通过如何查看产生费用的模型?及如何查看模型调用记录?确认费用详情。
该文章对您有帮助吗?