Source: https://wiki.niceai.dev/guide/clients/open-webui

# Open WebUI 接入自定义 API

在 Open WebUI 的管理员设置 **Connections** 中添加一个 OpenAI API 连接：URL 填 `https://api.niceai.dev/v1`，API Key 填 NiceAI 密钥，保存后在聊天页选择模型即可。用 Docker 部署时也可以通过环境变量一次配好。

## 准备工作

1. 已部署 Open WebUI，并使用管理员账号登录。
2. 在 NiceAI 控制台「[API 密钥](https://niceai.dev/keys)」页面创建密钥，分组按要用的模型选择。

## 配置步骤

1. 进入 **设置 → Connections**（管理员区域），找到 **Manage OpenAI API Connections**。
2. 点击 **Add Connection**。
3. **URL** 填 `https://api.niceai.dev/v1`，**API Key** 填 NiceAI 密钥。
4. 点击 URL 旁的 **Verify Connection** 测试连接，保存。
5. 回到聊天页，在模型选择器中选择模型。

**验证失败也不一定不能用**
Verify Connection 会请求 `/models` 接口获取模型列表。如果验证失败或列表里没有想要的模型，可以在连接设置的 **Model IDs** 中手动添加 [模型广场](https://niceai.dev/model-plaza) 里的模型名，点 **+** 后保存。


## 用 Docker 环境变量配置

```bash
docker run -d -p 3000:8080 \
  -e OPENAI_API_BASE_URL=https://api.niceai.dev/v1 \
  -e OPENAI_API_KEY=sk-你的密钥 \
  -v open-webui:/app/backend/data \
  --name open-webui \
  ghcr.io/open-webui/open-webui:main
```

环境变量只在首次初始化时写入，之后以管理员界面里的设置为准。

## 哪些功能会用到 NiceAI

Open WebUI 对话走 `/v1/chat/completions`。RAG 的向量化（embeddings）、语音、生图等功能分别需要对应的接口，是否能通过 NiceAI 使用，取决于你的分组是否提供这些接口；不确定时可以让这些功能继续使用本地或其他服务。

## 常见问题

### 返回 404？

URL 要以 `/v1` 结尾。见 [接口地址要不要加 /v1](https://wiki.niceai.dev/guide/v1-404)。

### 模型列表里出现很多用不了的模型？

在连接设置的 Model IDs 中只保留你要用的模型，列表会清爽很多。

## 下一步

- [NextChat 接入](https://wiki.niceai.dev/guide/clients/nextchat)
- [LobeChat 接入](https://wiki.niceai.dev/guide/clients/lobechat)
