> ## 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.

# 在 Open WebUI 中配置 Sub2API

> 在自托管的 Open WebUI 实例中添加 Sub2API 作为 OpenAI 兼容连接，通过 Web 界面访问多种 AI 模型。

Open WebUI 是一个可自托管的 Web 界面，用于与各种大语言模型交互。通过在 Open WebUI 中添加 Sub2API 作为 OpenAI 兼容连接，你可以通过浏览器访问 GPT、Claude、Gemini、Grok 等多种模型，并与团队成员共享使用。

## 前置条件

* 已部署 Open WebUI 实例（Docker 或本地安装）
* 已获取 Sub2API API Key（详见 [创建 API Key](/getting-started/create-api-key)）

## 配置步骤

<Steps>
  <Step title="访问管理面板">
    以管理员身份登录 Open WebUI，点击右上角头像或菜单进入「设置」/「Admin Panel」。

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

  <Step title="进入连接设置">
    在设置菜单中找到「Connections」或「连接」选项。选择「OpenAI API」连接类型。

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

  <Step title="添加新连接">
    点击「添加连接」或「Add Connection」按钮。

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

  <Step title="填写连接信息">
    根据提示填写以下配置：

    | 配置项     | 值                                 |
    | ------- | --------------------------------- |
    | API URL | `https://sub2api.ruilinlu.com/v1` |
    | API Key | 你的 Sub2API API Key                |

    <Note>
      TODO：请在后台确认实际配置后填写。（API 路径 `/v1` 及 Open WebUI 版本兼容性需确认）
    </Note>

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

  <Step title="保存并验证">
    点击「保存」按钮。Open WebUI 会自动验证连接并获取可用模型列表。

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

  <Step title="启用模型">
    在模型列表中选择你希望在 WebUI 中启用的模型，打开对应开关。

    <Tip>
      建议先启用常用的 2-3 个模型进行测试，确认正常后再启用更多模型。
    </Tip>

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

## 版本要求

<Info>
  TODO：请在后台确认实际配置后填写。（请确认支持的 Open WebUI 最低版本要求）
</Info>

## 故障排查

<Accordion title="保存后模型列表为空">
  * 确认 API URL 和 API Key 填写正确
  * 检查 Open WebUI 日志获取详细错误信息
  * 参考 [API Key 无效排查](/troubleshooting/api-key-invalid)
</Accordion>

<Accordion title="返回 401 认证失败">
  * 确认使用的是 Sub2API 控制台生成的 API Key
  * 参考 [401 错误排查](/troubleshooting/401)
</Accordion>

<Accordion title="模型响应异常">
  * 确认启用的模型名称与 Sub2API 支持的名称一致
  * 参考 [模型不可用排查](/troubleshooting/model-unavailable)
</Accordion>

<Accordion title="连接超时">
  * 确认 Open WebUI 服务器可以访问 `https://sub2api.ruilinlu.com`
  * 检查服务器防火墙或代理设置
  * 参考 [Base URL 配置](/configuration/base-url)
</Accordion>