Cherry Studio

更新时间:
复制 MD 格式

在 Cherry Studio 中使用阿里云百炼模型。

快速开始

  1. 1

    获取 API Key

    根据计费方案获取对应的 API Key:

  2. 2

    配置模型

    打开 Cherry Studio,点击右上角的设置按钮,在 模型 栏点击 添加,填写供应商名称(例如 百炼),提供商类型选择 OpenAI。按计费方案填写配置:

    Token Plan

    配置项值
    API 地址https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1
    API 密钥Token Plan 个人版或团队版专属 API Key
    模型填写个人版或团队版支持的文本生成模型

    按量计费

    按实际调用量后付费。将 {WorkspaceId} 替换为 Workspace ID,以下以华北2(北京)为例。

    配置项值
    API 地址https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1
    API 密钥百炼 API Key
    模型qwen3.8-max 或 qwen3.8-flash;可用模型见 OpenAI 兼容接口支持的模型

    Coding Plan

    配置项值
    API 地址https://coding.dashscope.aliyuncs.com/v1
    API 密钥Coding Plan 专属 API Key
    模型qwen3.7-plus;可用模型见 Coding Plan 支持的模型
  3. 3

    验证

    在 模型 ID 填入模型,点击 添加。返回对话界面,选择刚添加的模型并发送任意消息,模型正常返回响应即配置成功。

错误码

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

常见问题

如何按量计费接入节省计划与资源包?

按量计费接入方式不变,使用百炼通用 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 地址是否与目标地域匹配,详情请参见新人免费额度。
  • 额度按模型独立计算:各模型的免费额度相互独立,不可跨模型共享。
  • 数据更新延迟:控制台显示的免费额度数据每小时更新。即使控制台显示仍有余量,实际额度也可能已耗尽。

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