Open WebUI 集成
自托管 ChatGPT-like 界面通过 OpenAI API connection 接入本平台全部 90+ 模型
Open WebUI 是开源 ChatGPT-like 界面,支持自托管 + 多模型 + 用户系统,通过 OpenAI 兼容 API connection 接入本平台后全部目录模型(90+,随目录持续更新)立即可用。
安装 (Docker)#
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,首次创建管理员账户。
配置#
- Settings → ⚙️ Connections
- OpenAI API 部分:
- API Base URL:
https://api.dflop.top/v1 - API Key: 你的
sk-gpushare-*Key(sk-gpushare-+ 64 位十六进制;在 控制台 Key 页 创建,详情页可随时重新查看)
- API Base URL:
- 点 Verify Connection 确认连通
- 保存
注意: Verify Connection 走的是
GET /v1/models,该端点不校验账户余额 —— 余额耗尽时连接验证照样通过,但每次对话都会报 402,见下方常见问题。
模型选择#
保存连接后,平台目录中的模型自动出现在模型选择器中(从 GET /v1/models 拉取,数量随目录更新,无需手填)。
建议先关掉非对话 SKU: /v1/models 返回的是全部目录,其中图像(doubao-seedream-*、grok-imagine-image*)、视频(doubao-seedance-*、grok-imagine-video*)与 3D SKU 走的是独立端点,在聊天界面调用只会报错(400 invalid_request 或 503 no_channel_available)。
配置方法:
- Settings → ⚙️ Models
- 把非对话 SKU 与不想暴露给用户的模型 toggle off
多用户 / 团队场景#
Open WebUI 自带用户系统,所有用户共用你配置的那把平台 Key;而本平台侧所有 Key 共享同一账户余额(统一钱包,Key 没有独立预算池)。建议:
- 为 Open WebUI 单建一把专用 Key —— 价值在用量归因(在 用量页 按 Key 查看)和
allowed_models模型白名单(限制这把 Key 能调哪些模型),不是预算隔离 - 需要硬性预算隔离时,为团队单独注册账户(余额按账户计,充值入口在主站 dflop.top/dashboard/billing,与 model.dflop.top 同账号 SSO)
- 通过 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 默认启用流式,跟本平台协议完全兼容。详见 流式响应。
工具调用#
Open WebUI 的 Functions 系统支持 OpenAI function tools 调用,本平台绝大多数对话模型都支持(以 模型广场 / 模型列表 标注的 supports_tools 为准;图像 / 视频 / embedding SKU 不支持)。详见 工具调用。
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 系列,见 模型广场)→ 走本网关内置。注意该 tool 仅流式请求可用(Open WebUI 默认流式,通常无需关心)
常见问题#
| 现象 | 排查 |
|---|---|
| 模型列表为空 | API Base URL 拼写;/v1 不能少 |
401 invalid_api_key | API Key 是否复制全(sk-gpushare- + 64 位十六进制,共 76 字符);可在 Key 详情页 重新查看 |
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 花了多少 | 用量页 按 Key 查看 |
其他客户端#
- Claude Code — 命令行 AI 编程
- Cursor — IDE 内置 AI
- Cline (VS Code) — agentic AI Coding
- Continue.dev — VS Code / JetBrains
- FlopCode — 本平台官方 fork