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

# 在 Chatbox 中配置 Sub2API

> 在 Chatbox 桌面客户端中设置 Sub2API 为 OpenAI API 提供商，享受跨平台 AI 对话体验。

Chatbox 是一款跨平台的桌面 AI 客户端，支持 Windows、macOS 和 Linux。通过将 Sub2API 配置为 Chatbox 的 API 提供商，你可以在本地客户端中轻松切换和使用多种 AI 模型。

## 前置条件

* 已下载并安装 Chatbox（支持 Windows、macOS、Linux）
* 已获取 Sub2API API Key（详见 [创建 API Key](/getting-started/create-api-key)）

## 配置步骤

<Steps>
  <Step title="打开 Chatbox">
    启动 Chatbox 客户端，进入主界面。
  </Step>

  <Step title="进入设置">
    点击左下角或顶部菜单的「设置」/「Settings」图标。

    > 截图占位：此处可插入实际客户端配置截图
  </Step>

  <Step title="选择 AI 提供商">
    在设置中找到「AI Provider」或「API 提供商」选项，选择「OpenAI API」。

    > 截图占位：此处可插入实际客户端配置截图
  </Step>

  <Step title="设置 API Host">
    将 API Host 或 API Base URL 设置为：

    ```text theme={null}
    https://sub2api.ruilinlu.com
    ```

    > 截图占位：此处可插入实际客户端配置截图
  </Step>

  <Step title="填写 API Key">
    在 API Key 字段中粘贴你的 Sub2API API Key。

    > 截图占位：此处可插入实际客户端配置截图
  </Step>

  <Step title="选择模型">
    在模型下拉框中选择要使用的模型，或手动输入自定义模型名称。

    <Note>
      如果所需模型未出现在下拉列表中，可以手动输入模型名称。Sub2API 支持的具体模型名称请查看 [模型选择指南](/models/how-to-choose)。
    </Note>

    > 截图占位：此处可插入实际客户端配置截图
  </Step>

  <Step title="保存并测试">
    点击「保存」按钮，然后新建一个对话发送测试消息，确认连接正常。
  </Step>
</Steps>

## 故障排查

<Accordion title="连接失败或超时">
  * 确认 API Host 已设置为 `https://sub2api.ruilinlu.com`
  * 检查网络连接是否正常
  * 参考 [Base URL 配置](/configuration/base-url)
</Accordion>

<Accordion title="返回 401 认证错误">
  * 确认 API Key 已正确复制，无多余空格
  * 参考 [401 错误排查](/troubleshooting/401)
</Accordion>

<Accordion title="自定义模型名称无效">
  * 确认手动输入的模型名称与 Sub2API 支持的名称一致
  * 参考 [模型不可用排查](/troubleshooting/model-unavailable)
</Accordion>