# Open WebUI 集成

> 自托管 ChatGPT-like 界面通过 OpenAI API connection 接入本平台全部 205+ 模型

来源：https://model.dflop.top/docs/integrations/open-webui

> [Open WebUI](https://openwebui.com/) 是开源 ChatGPT-like 界面,支持自托管 + 多模型 + 用户系统,通过 OpenAI 兼容 API connection 接入本平台后全部目录模型(200+,随目录持续更新)立即可用。

## 安装 (Docker)

```bash
docker run -d \
  -p 3000:8080 \
  -v open-webui:/app/backend/data \
  --name open-webui \
  --restart always \
  ghcr.io/open-webui/open-webui:main
```

访问 `http://localhost:3000`,首次创建管理员账户。

## 配置

1. Settings → ⚙️ **Connections**
2. **OpenAI API** 部分:
   - **API Base URL**: `https://api.dflop.top/v1`
   - **API Key**: 你的 `sk-gpushare-*` Key(`sk-gpushare-` + 64 位十六进制;在 [控制台 Key 页](https://model.dflop.top/dashboard/keys) 创建,详情页可随时重新查看)
3. 点 **Verify Connection** 确认连通
4. 保存

> **注意**: Verify Connection 走的是 `GET /v1/models`,该端点不校验账户余额 —— 余额耗尽时连接验证照样通过,但每次对话都会报 402,见下方[常见问题](#常见问题)。

## 模型选择

保存连接后,平台目录中的模型**自动出现**在模型选择器中(从 `GET /v1/models` 拉取,数量随目录更新,无需手填)。

**建议先关掉非对话 SKU**: `/v1/models` 返回的是全部目录,其中图像(`doubao-seedream-*`、`grok-imagine-image*`)、视频(`doubao-seedance-*`、`grok-imagine-video*`)与 3D SKU 走的是[独立端点](../reference/media-apis.md),在聊天界面调用只会报错(400 `invalid_request` 或 503 `no_channel_available`)。

配置方法:

1. Settings → ⚙️ **Models**
2. 把非对话 SKU 与不想暴露给用户的模型 toggle off

## 多用户 / 团队场景

Open WebUI 自带用户系统,所有用户共用你配置的那把平台 Key;而本平台侧**所有 Key 共享同一账户余额**(统一钱包,Key 没有独立预算池)。建议:

1. 为 Open WebUI 单建一把专用 Key —— 价值在**用量归因**(在 [用量页](https://model.dflop.top/dashboard/usage) 按 Key 查看)和 `allowed_models` **模型白名单**(限制这把 Key 能调哪些模型),**不是预算隔离**
2. 需要硬性预算隔离时,为团队单独注册账户(余额按账户计,充值入口在主站 dflop.top/dashboard/billing,与 model.dflop.top 同账号 SSO)
3. 通过 Open WebUI 自己的 user permissions 限制单用户能用哪些模型

## RAG / Embeddings

平台已于 2026-07 下架 embedding SKU,`POST /v1/embeddings` 当前没有可用模型。Open WebUI 的 RAG (knowledge base) 请用本地方案:

Settings → ⚙️ **Documents** → **Embedding Model Engine**:
- 默认的 SentenceTransformers(内置,离线),或 `Ollama` + `nomic-embed-text`(本地,免费)

## 流式响应

Open WebUI 默认启用流式,跟本平台协议完全兼容。详见 [流式响应](../guides/streaming.md)。

## 工具调用

Open WebUI 的 **Functions** 系统支持 OpenAI function tools 调用,本平台**绝大多数对话模型**都支持(以 [模型广场](https://model.dflop.top/models) / [模型列表](../reference/models.md) 标注的 `supports_tools` 为准;图像 / 视频 / embedding SKU 不支持)。详见 [工具调用](../guides/tool-calling.md)。

## Web Search

Open WebUI 自身的 Web Search 是独立功能,**不走本网关的 `web_search` tool**。两者可平行使用:

- Open WebUI Web Search → 走你配的 SearXNG / Google CSE / Brave API
- 支持内置 `web_search` 的模型(GPT-5.x / 部分 Claude / Gemini 系列,见 [模型广场](https://model.dflop.top/models))→ 走本网关内置。注意该 tool 仅流式请求可用(Open WebUI 默认流式,通常无需关心)

## 常见问题

| 现象 | 排查 |
|---|---|
| 模型列表为空 | API Base URL 拼写;`/v1` 不能少 |
| 401 `invalid_api_key` | API Key 是否复制全(`sk-gpushare-` + 64 位十六进制,共 76 字符);可在 [Key 详情页](https://model.dflop.top/dashboard/keys) 重新查看 |
| Verify Connection 通过,对话却报 402 `insufficient_quota` | 账户余额耗尽(连接验证不校验余额)。所有 Key 共享余额,新建 Key 无效;到 dflop.top/dashboard/billing 充值 |
| 个别模型一点就报 400 / 503 | 图像 / 视频 / embedding 等非对话 SKU 不能在聊天界面用,toggle off 即可,见上方「[模型选择](#模型选择)」 |
| 流式不工作 | Open WebUI 反向代理 buffering 是否关 (Nginx `proxy_buffering off`) |
| 想看这把 Key 花了多少 | [用量页](https://model.dflop.top/dashboard/usage) 按 Key 查看 |

## 其他客户端

- [Claude Code](./claude-code.md) — 命令行 AI 编程
- [Cursor](./cursor.md) — IDE 内置 AI
- [Cline (VS Code)](./cline.md) — agentic AI Coding
- [Continue.dev](./continue.md) — VS Code / JetBrains
- [FlopCode](./flopcode.md) — 本平台官方 fork