> ## Documentation Index
> Fetch the complete documentation index at: https://docs.siflow.cn/llms.txt
> Use this file to discover all available pages before exploring further.

# Chatbox

> 了解如何在 Chatbox 桌面客户端中配置 OpenAI provider、API Host 和 API Key，接入 siflow endpoint 并使用算秩模型对话。

[Chatbox](https://chatboxai.app) 是一款跨平台桌面 AI 客户端，支持 Windows、macOS 和 Linux，也提供 Web 版本。它内置的 OpenAI provider 支持自定义 API Host，因此可以将请求指向 siflow endpoint，并使用模型。

支持的模型包括 `glm-5.2` 和 `DeepSeek-V4-Flash`。完整模型列表和价格请参考 [模型广场](https://console.siflow.cn/model-inference/models)。

## 配置

以下以 Chatbox App 为例，[Web 版 Chatbox](https://web.chatboxai.app) 的配置方式类似。

1. 打开 **Settings**（左下角齿轮图标），进入 **Model Provider**。

2. 在 provider 列表中选择内置的 **OpenAI** provider，填写所需字段。

   | 参数       | 说明                                                                             |
   | -------- | ------------------------------------------------------------------------------ |
   | API Key  | 您在 [API 密钥](https://console.siflow.cn/model-inference/api_keys) 页面创建的 API Key。 |
   | API Host | `https://api.siflow.cn/model-api/v1`，不要以 `/` 或 `#` 结尾。                         |

3. 在模型区域单击 **Fetch**，加载模型列表，然后添加需要使用的模型，例如 `glm-5.2`。

   如果**无法获取模型列表**，请检查 API Host 和 API Key 是否正确。您也可以单击 **+ New** 手动添加模型 ID。单击 **Reset** 会清空模型列表。

4. 单击 **Check** 并选择模型，测试连接。

   Chatbox 会显示 **Model Test Results** 弹窗，并分别检查 Text、Vision、Tool Use Request 等能力。如果看到 `Connection successful!`，则表示连接成功。

   **Model Test Results** 会按模型报告 Vision 和 Tool Use 支持情况。某个模型可能通过 Text 测试，但不支持 Vision。如果依赖 tool/function 功能，请选择原生支持 tool calling 的模型。

<img src="https://mintcdn.com/siflow/MnqDOrFLyFtwF7sA/model-inference/media/chatbox-provider-config.png?fit=max&auto=format&n=MnqDOrFLyFtwF7sA&q=85&s=abbc186ef27d5bc76e26b52c2bff6510" alt="Chatbox 中配置 OpenAI provider 接入算秩并通过模型测试" width="2048" height="1536" data-path="model-inference/media/chatbox-provider-config.png" />

## 验证

新建一个对话，在底部模型选择器中选择一个算秩提供的模型，然后发送消息。如果模型正常回复，即表示连接成功。消息底部会显示 `OpenAI API (<model>)`。

<img src="https://mintcdn.com/siflow/MnqDOrFLyFtwF7sA/model-inference/media/chatbox-chat-reply.png?fit=max&auto=format&n=MnqDOrFLyFtwF7sA&q=85&s=68446d4568cecfc3783fc61061eada62" alt="Chatbox 使用算秩模型进行对话" width="1622" height="1536" data-path="model-inference/media/chatbox-chat-reply.png" />
