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,首次创建管理员账户。

配置#

  1. Settings → ⚙️ Connections
  2. OpenAI API 部分:
    • API Base URL: https://api.dflop.top/v1
    • API Key: 你的 sk-gpushare-* Key(sk-gpushare- + 64 位十六进制;在 控制台 Key 页 创建,详情页可随时重新查看)
  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 走的是独立端点,在聊天界面调用只会报错(400 invalid_request 或 503 no_channel_available)。

配置方法:

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

多用户 / 团队场景#

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

  1. 为 Open WebUI 单建一把专用 Key —— 价值在用量归因(在 用量页 按 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 → ⚙️ DocumentsEmbedding Model Engine:

  • 默认的 SentenceTransformers(内置,离线),或 Ollama + nomic-embed-text(本地,免费)

流式响应#

Open WebUI 默认启用流式,跟本平台协议完全兼容。详见 流式响应

工具调用#

Open WebUI 的 Functions 系统支持 OpenAI function tools 调用,本平台绝大多数对话模型都支持(以 模型广场 / 模型列表 标注的 supports_tools 为准;图像 / 视频 / embedding SKU 不支持)。详见 工具调用

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_keyAPI 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 查看

其他客户端#