providers.md

icon	cloud-check

模型服务设置

当前页面仅做界面功能的介绍，配置教程可以参考基础教程中的 服务商配置 教程。

{% hint style="info" %}

• 在使用内置服务商时只需要填写对应的秘钥即可。
• 不同服务商对秘钥的叫法可能有所不同，秘钥、Key、API Key、令牌等都指的是同一个东西。 {% endhint %}

API 秘钥

在 Cherry Studio 当中，单个服务商支持多 Key 轮询使用，轮询方式为从前到后列表循环的方式。

• 多 Key 用英文逗号隔开添加。如以下示例方式：

sk-xxxx1,sk-xxxx2,sk-xxxx3,sk-xxxx4

{% hint style="warning" %} 必须使用 英文 逗号。 {% endhint %}

API 地址

在使用内置服务商时一般不需要填写 API 地址，如果需要修改请严格按照对应的官方文档给的地址填写。

如果服务商给的地址为 https://xxx.xxx.com/v1/chat/completions 这种格式，只需要填写根地址部分（https://xxx.xxx.com）即可。

Cherry Studio 会自动拼接剩余的路径（/v1/chat/completions），未按要求填写可能会导致无法正常使用。

{% hint style="info" %} 说明：大多数服务商的大语言模型路由是统一的，一般情况下不需要进行如下操作。如果服务商请求路由不是常规的 /v1/chat/completions 时，可在 API 地址栏手动输入 完整的API地址，并以 #结尾。

即：

• API地址使用 # 结尾时不执行拼接操作，只使用填入的地址。 {% endhint %}

添加模型

一般情况下点击服务商配置页面最左下角的 管理 按钮会自动获取该服务商所有支持调用的模型，从获取列表中点击 + 号添加到模型列表即可。

{% hint style="info" %} 点击管理按钮时弹窗列表里的模型不会全部添加，需要点击模型右侧的 + ，添加到服务商配置页面的模型列表才可以在模型选择列表当中出现。 {% endhint %}

连通性检查

点击API 秘钥输入框后的检查按钮即可测试是否成功配置。

{% hint style="info" %} 模型检查时默认使用模型列表已添加模型的最后一个对话模型，如果检查时有失败的情况请检查模型列表是否有错误的或不被支持的模型。 {% endhint %}

{% hint style="danger" %} 配置成功后务必打开右上角的开关，否则该服务商仍处于未启用状态，无法在模型列表中找到对应模型。 {% endhint %}