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

# Open WebUI

> 如何把自托管的 Open WebUI 接到 RuAPI:设置 OpenAI API Base URL 或环境变量

[Open WebUI](https://openwebui.com) 是个自托管的模型聊天 Web 界面。除了 Ollama,它还能对接任意 **OpenAI 兼容** API,所以 RuAPI 当成一个 OpenAI 连接接入即可 —— 填地址和密钥就行。

## 前置

<Steps>
  <Step title="RuAPI 账号和密钥">
    控制台 →\*\*「令牌」\*\*→ 创建 `sk-...` 密钥。余额用 USDT 充 —— 见[充值](/zh/topup)。
  </Step>

  <Step title="跑起来的 Open WebUI">
    按 [Open WebUI 文档](https://docs.openwebui.com)安装(一般用 Docker)。
  </Step>
</Steps>

## 方式一:界面里配

<Steps>
  <Step title="打开连接设置">
    **Admin Panel → Settings → Connections**(或当前用户的 Settings → Connections)。
  </Step>

  <Step title="加一个 OpenAI 连接">
    启用 OpenAI API 并填:

    | 字段               | 值                                         |
    | ---------------- | ----------------------------------------- |
    | **API Base URL** | `https://www.ruapi.ai/v1`  —— **带** `/v1` |
    | **API Key**      | `sk-你的密钥`                                 |

    保存。Open WebUI 会通过 `/v1/models` 拉取模型列表。
  </Step>
</Steps>

## 方式二:用环境变量

启动容器时设置:

```bash theme={null}
docker run -d -p 3000:8080 \
  -e OPENAI_API_BASE_URL=https://www.ruapi.ai/v1 \
  -e OPENAI_API_KEY=sk-你的密钥 \
  -v open-webui:/app/backend/data \
  --name open-webui ghcr.io/open-webui/open-webui:main
```

## 验证

新建聊天,选个模型(例如 `claude-opus-4-8`)发消息。有回复 + RuAPI 控制台 →\*\*「日志」\*\*有记录 = 正常。

## 出问题时

<AccordionGroup>
  <Accordion title="模型列表是空的">
    * 确认 Base URL 是带 `/v1` 的 `https://www.ruapi.ai/v1`:模型靠 `/v1/models` 拉取。
    * 密钥得是 RuAPI 令牌(`sk-...`)。
  </Accordion>

  <Accordion title="401 / 授权失败">
    密钥错了或有空格。在 RuAPI 控制台 →\*\*「令牌」\*\*核对状态。
  </Accordion>

  <Accordion title="想同时留着 Ollama 和 RuAPI">
    可以:Open WebUI 支持同时多个连接。本地 Ollama 模型和云端 RuAPI 模型会在同一个选择列表里。
  </Accordion>
</AccordionGroup>