Cherry Studio

​

安装 Cherry Studio

前往 Cherry Studio 下载页面，根据操作系统下载安装包并完成安装。

​

配置接入凭证

打开 Cherry Studio，点击右上角的设置按钮，在模型栏点击添加，填写供应商名称（如 Token Plan 团队版），提供商类型选择 OpenAI。 百炼提供四种计费方案，根据需要选择：

• Token Plan 个人版：按 token 消耗抵扣个人 Credits。
• Token Plan 团队版：按坐席订阅，按 token 消耗抵扣 Credits。
• Coding Plan：固定月费订阅，按模型调用次数计量。
• 按量计费：按实际调用量后付费。

​

Token Plan 个人版

配置项	说明
API 密钥	填入 Token Plan 个人版专属 API Key。
API 地址	https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1
模型	可用模型请参考 Token Plan 个人版支持的模型。

​

Token Plan 团队版

配置项	说明
API 密钥	填入 Token Plan 团队版专属 API Key。
API 地址	https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1
模型	可用模型请参考 Token Plan 团队版支持的模型。

​

Coding Plan

配置项	说明
API 密钥	填入 Coding Plan 专属 API Key。
API 地址	https://coding.dashscope.aliyuncs.com/v1
模型	可用模型请参考 Coding Plan 支持的模型。

​

按量计费

配置项	说明
API 密钥	填入阿里云百炼 API Key。
API 地址	根据地域，填入对应 URL（请将 URL 中的 {WorkspaceId} 替换为真实的获取Workspace ID）： 华北2（北京）：https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1 新加坡：https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1 美国（弗吉尼亚）：https://{WorkspaceId}.us-east-1.maas.aliyuncs.com/compatible-mode/v1
模型	填入支持的模型。

​

验证配置

在模型 ID填入需要使用的模型，点击添加。返回对话界面，输入任意问题，模型正常返回响应即配置成功。

如果是 RAM 子账号，请参见业务空间管理，确保拥有模型的调用权限。

​

常见问题

​

错误码

配置过程中遇到报错，请参考对应计费方案的常见问题文档：

• 按量计费：错误码排查
• Coding Plan：Coding Plan 常见问题
• Token Plan 个人版：Token Plan 常见问题
• Token Plan 团队版：Token Plan 团队版常见问题

​

报错 The value of the enable_thinking parameter is restricted to True

原因：该模型仅支持在思考模式下运行，但调用时未开启思考模式。 解决方案：在客户端中开启思考模式。

​

接入按量计费时，有免费额度但产生了费用

可能的原因：

• 地域不匹配：免费额度仅适用于华北2（北京）地域的模型。使用其他地域的模型会产生费用。请检查API 地址是否与目标地域匹配，详情请参见新人免费额度。
• 额度按模型独立计算：各模型的免费额度相互独立，不可跨模型共享。
• 数据更新延迟：控制台显示的免费额度数据每小时更新。即使控制台显示仍有余量，实际额度也可能已耗尽。

可通过如何查看产生费用的模型？及如何查看模型调用记录？确认费用详情。