Model Server 使用指南

外观

Cherry Studio 配置 ​

Cherry Studio 是跨平台桌面聊天客户端，适合管理多个供应商、模型和对话场景。

接入协议OpenAI Compatible / Chat Completions
打开安装说明

配置步骤

  1. 1

    打开 Cherry Studio，点击窗口左下角的设置齿轮。

  2. 2

    进入模型服务，点击供应商列表底部的“添加服务商”。

  3. 3

    名称填写 Model Server，OpenAI 和 Anthropic 端点都填写下方 API 地址，再填写自己的 API Key，然后点击“添加”。

  4. 4

    选中 Model Server，点击“获取模型列表”。

  5. 5

    找到下方显示的模型名称，点击该行最右侧的加号。

  6. 6

    关闭模型列表弹窗，再点击窗口左上角的“返回”。

  7. 7

    点击聊天页顶部当前模型，在 Model Server 分组中选择刚添加的模型。

  8. 8

    输入一条简单消息并发送，确认模型能够正常回复。

复制配置

Cherry Studio 供应商字段

名称: Model Server
协议: OpenAI Compatible
OpenAI 端点: 
Anthropic 端点: 
API Key: sk-your-api-key
模型 ID: gpt-5.6-sol
看图操作

Cherry Studio 配置流程图

按照 8 张真实界面截图完成配置：进入设置、添加 Model Server、获取并添加模型，最后回到聊天页选择模型并发送消息验证。

界面可能随版本变化
  1. 第 1 步

    从聊天页打开设置

    1. 1

      点击窗口左下角的设置齿轮。

    打开 Cherry Studio 后，点击窗口左下角的齿轮按钮进入设置。

    自行采集Cherry Studio 当前稳定版
  2. 第 2 步

    在模型服务中添加供应商

    1. 1

      点击供应商列表底部的“添加服务商”。

    设置页默认打开模型服务；如果没有打开，请先点击左侧“模型服务”，再点击供应商列表底部的“添加服务商”。

    自行采集Cherry Studio 当前稳定版
  3. 第 3 步

    填写供应商连接信息

    1. 1

      提供商名称填写 Model Server。

    2. 2

      API 密钥粘贴自己的完整 API Key。

    3. 3

      OpenAI 端点填写页面复制区中的 /v1 地址。

    4. 4

      Anthropic 端点也填写同一个 /v1 地址。

    5. 5

      确认以上内容无误后，点击“添加”。

    名称填写 Model Server，API 密钥粘贴自己的完整密钥，OpenAI 和 Anthropic 端点都填写页面复制区中的 /v1 地址，最后点击“添加”。截图中的密钥已隐藏。

    自行采集Cherry Studio 当前稳定版
  4. 第 4 步

    获取 Model Server 模型列表

    1. 1

      点击“获取模型列表”，让 Cherry Studio 读取可用模型。

    选中刚添加的 Model Server 供应商，确认 API 密钥和地址已经显示，然后点击“获取模型列表”。

    自行采集Cherry Studio 当前稳定版
  5. 第 5 步

    把需要的模型加入 Cherry Studio

    1. 1

      在目标模型这一行点击最右侧的加号；不要按截图照抄模型名。

    在列表中找到页面复制区给出的模型名称，点击该行最右侧的加号。截图以 Claude Fable 5 为界面示例，实际模型名称可能不同。

    自行采集Cherry Studio 当前稳定版
  6. 第 6 步

    关闭模型列表并返回聊天页

    1. 1

      先点击模型列表右上角的 × 关闭弹窗。

    2. 2

      弹窗关闭后，点击窗口左上角的“返回”。

    目标模型变成绿色表示已经添加。先关闭模型列表弹窗，再点击设置页左上角的“返回”，回到聊天页面。

    自行采集Cherry Studio 当前稳定版
  7. 第 7 步

    为当前聊天选择 Model Server 模型

    1. 1

      点击聊天页顶部当前使用的模型名称。

    2. 2

      在 Model Server 分组中点击刚添加的模型。

    点击聊天页顶部当前模型名称，在 Model Server 分组中点击刚添加的模型。截图中的 Claude Fable 5 仅为示例。

    自行采集Cherry Studio 当前稳定版
  8. 第 8 步

    发送消息验证连接

    1. 1

      确认顶部显示的是刚选择的 Model Server 模型。

    2. 2

      收到正常回复即表示 API 地址、密钥和模型均可用。

    输入一条简单消息并按 Enter 发送。顶部显示所选的 Model Server 模型且收到正常回复，就表示配置成功。

    自行采集Cherry Studio 当前稳定版

看不清时：点击图片可放大；配置值请复制页面中的文字，不要照着截图手工输入密钥或地址。

验证配置

选择刚添加的模型并发送“介绍一下你自己”；能够流式返回内容即配置成功。

配置示例中如果出现 sk-your-api-key 必须替换为自己的完整密钥；不要把含密钥的配置提交到 Git。

常见错误 ​

  • 测试连接失败：确认协议是 OpenAI Compatible，API 地址以 /v1 结尾。
  • 模型列表为空：手动添加文档显示的 Model ID。
  • 无法使用工具：确认 Endpoint Type 和模型能力设置正确。

更多通用错误处理见常见问题。