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

# ChatBox

> 在 ChatBox 桌面客户端中接入 OpenPAI

[ChatBox](https://chatboxai.app/) 是一款支持 Windows / macOS / Linux / iOS / Android 的开源跨平台 AI 桌面客户端。

## 配置步骤

<Steps>
  <Step title="打开设置">
    左下角齿轮图标 → **设置**。
  </Step>

  <Step title="选择模型提供方">
    在 **AI 提供方 / Model Provider** 中选择 **OpenAI API**(也可选择自定义)。
  </Step>

  <Step title="填写连接信息">
    * **API Host / API 地址**:`https://openp.ai/v1`
    * **API Key / API 密钥**:`sk-XXXXXXXXXXXXXXXX`
    * **模型 / Model**:在下拉中选择或填入自定义模型 ID,如 `gpt-5.5`、`claude-opus-4-8`
  </Step>

  <Step title="保存并开始对话">
    回到主界面新建会话,顶部选择模型即可使用。
  </Step>
</Steps>

## 添加多个模型

ChatBox 支持在 **模型列表** 中预设多个模型,切换会话时直接选择即可:

1. 设置 → 模型 → 添加自定义模型。
2. 填入 OpenPAI 控制台上的模型 ID。
3. 保存后,主界面对话顶部下拉菜单中即可看到。

推荐预设的模型组合:

* `gpt-5.4-mini`(日常对话,便宜)
* `claude-opus-4-8`(代码与长文)
* `gemini-3.1-pro-preview`(超长上下文)
* `o3-mini-high`(复杂推理)
* `dall-e-3` / `gpt-image-1`(图像生成)

## 移动端

ChatBox 的 iOS / Android 应用同样支持自定义 API Host,
配置流程与桌面端一致。建议把 API Key 设置为有额度上限的子令牌以防止丢失设备造成损失。

## 注意

* ChatBox 默认使用 OpenAI 协议,因此 Base URL 必须包含 `/v1`。
* 若 ChatBox 提示 "无法连接" / "Network Error",请检查:
  * 网络是否能访问 `https://openp.ai`。
  * Base URL 末尾是否多余了斜杠。
  * 系统代理是否影响请求。