Model Server 使用指南

外观

Chatbox 配置 ​

Chatbox 是轻量的跨平台桌面聊天客户端，支持自建 OpenAI 兼容供应商。

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

配置步骤

  1. 1

    在聊天页面点击左上角菜单，再点击侧边菜单底部的设置齿轮。

  2. 2

    进入“模型提供方”，点击页面底部“添加”。

  3. 3

    选择“添加自定义提供商”，名称填写 Model Server，API 模式选择 OpenAI API 兼容，然后点击“添加”。

  4. 4

    填写 API Key、API 主机和 API 路径；确认预览地址只包含一次 /v1/chat/completions。

  5. 5

    点击“获取”，在模型列表中添加页面复制区显示的模型。

  6. 6

    返回聊天页面，点击输入框右下角“选择模型”。

  7. 7

    在 Model server 分组选择刚添加的模型，然后发送消息验证。

复制配置

Chatbox 供应商字段

名称: Model Server
API 模式: OpenAI API Compatible
API Host: 
API Path: /chat/completions
API Key: sk-your-api-key
模型 ID: gpt-5.6-sol
看图操作

Chatbox手机版 配置流程图

按照当前 Chatbox 手机端真实界面，从左上角菜单进入设置，添加 OpenAI API 兼容供应商，获取并选择 Model Server 模型，最后发送消息验证。

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

    点击左上角菜单按钮

    1. 1

      点击左上角的三条横线，打开侧边菜单。

    打开 Chatbox 聊天页面，点击左上角的三条横线按钮，展开侧边菜单。

    自行采集Chatbox 1.22.6（手机端自行截图）
  2. 第 2 步

    点击侧边菜单底部的设置齿轮

    1. 1

      点击底部的齿轮按钮，进入设置。

    侧边菜单展开后，点击底部靠右的齿轮按钮。齿轮按钮用于打开 Chatbox 设置。

    自行采集Chatbox 1.22.6（手机端自行截图）
  3. 第 3 步

    进入“模型提供方”

    1. 1

      点击“模型提供方”这一行。

    在设置列表中点击第二项“模型提供方”。这里用于管理 Chatbox 连接的 AI 服务。

    自行采集Chatbox 1.22.6（手机端自行截图）
  4. 第 4 步

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

    1. 1

      点击页面底部的“添加”按钮。

    进入模型提供方列表后，向下查看页面底部，点击带加号的“添加”按钮。

    自行采集Chatbox 1.22.6（手机端自行截图）
  5. 第 5 步

    选择“添加自定义提供商”

    1. 1

      点击“添加自定义提供商”。

    在弹出的供应商页面向下找到“自定义添加”，然后点击“添加自定义提供商”。不要选择上方的其他品牌供应商。

    自行采集Chatbox 1.22.6（手机端自行截图）
  6. 第 6 步

    填写名称并选择 OpenAI API 兼容

    1. 1

      名称填写 Model Server，API 模式选择“OpenAI API 兼容”，然后点击“添加”。

    名称填写 Model Server，API 模式选择“OpenAI API 兼容”，然后点击底部“添加”。OpenAI API 兼容表示该供应商使用与 OpenAI 相同的请求格式。

    自行采集Chatbox 1.22.6（手机端自行截图）
  7. 第 7 步

    填写连接信息并获取模型

    1. 1

      填写 API Key、API 主机和 API 路径，确认预览地址正确后，点击“获取”加载模型。

    API 密钥粘贴自己的完整密钥；API 主机和 API 路径分别填写页面复制区提供的值。API 主机是服务器地址，API 路径是请求接口路径。确认预览地址只包含一次 /v1/chat/completions，再点击“获取”。截图中的地址仅用于定位字段，实际值以页面复制区为准。

    自行采集Chatbox 1.22.6（手机端自行截图）
  8. 第 8 步

    添加页面提供的模型

    1. 1

      点击目标模型右侧的绿色加号；出现红色减号表示已经加入。

    2. 2

      选好后向下滑动顶部横条，关闭模型列表。

    在模型列表中找到页面复制区显示的模型名称，点击右侧绿色加号将它加入 Chatbox；红色减号表示已经加入。完成后向下滑动顶部横条，关闭模型列表并返回对话。截图中的模型名称只用于说明位置。

    自行采集Chatbox 1.22.6（手机端自行截图）
  9. 第 9 步

    打开对话底部的模型选择器

    1. 1

      点击输入框右下角的“选择模型”。

    返回聊天页面后，点击消息输入框右下角的“选择模型”按钮，打开模型列表。

    自行采集Chatbox 1.22.6（手机端自行截图）
  10. 第 10 步

    在 Model server 分组选择模型

    1. 1

      在 Model server 分组选择页面复制区显示的模型。

    向下滚动到“Model server”分组，点击页面复制区显示的模型名称。截图以 gpt-5.5 为例，实际必须选择页面当前显示的模型。

    自行采集Chatbox 1.22.6（手机端自行截图）
  11. 第 11 步

    发送消息验证配置

    1. 1

      发送前确认这里显示的是刚选择的 Model Server 模型。

    2. 2

      收到正常回复即表示配置成功。

    确认输入框底部显示刚选择的模型，输入一句简单问题并发送。收到正常回复，表示 API 地址、密钥和模型都已配置成功。

    自行采集Chatbox 1.22.6（手机端自行截图）

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

验证配置

发送一条简单消息；能够正常返回且模型名称正确即配置成功。

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

常见错误 ​

  • 返回 404：检查 API Host 和 API Path 是否重复包含 /chat/completions。
  • 找不到模型：在供应商设置中手动添加 Model ID。
  • Failed to fetch：检查系统代理、防火墙和 API Host 可达性。

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