Open WebUI
Open WebUI 将 UberLLM 添加为 OpenAI API 连接。
开始之前
- 一个有余额的 UberLLM 账户,以及一个来自
Dashboard → 密钥 (
ull_...) 的 API key。
设置 (管理员连接,供服务器上的所有人使用)
- 前往 设置 → 管理员 → 连接。
- 在 管理 OpenAI API 连接 下方,点击 ➕ 添加连接。
- 填写:
- URL:
https://api.uberllm.dev/v1 - API Key: 您的
ull_...密钥 (将认证类型保留为 Bearer)
- URL:
- 打开 高级 (可选但推荐):
- Prefix ID:
uberllm. 模型将显示为uberllm.z-ai/glm-5.2,这样它们就不会与您其他连接中的模型冲突。Open WebUI 会在发送请求前移除此前缀。 - Model IDs: 添加您想要的模型,每次一个,使用 + (见下文)。设置此列表后,Open WebUI 将只显示这些模型,并停止加载完整列表。
- Headers:
{"X-Title": "Open WebUI"}告诉 UberLLM 是哪个应用发送了请求。
- Prefix ID:
- 将 API 类型 保留为 Chat Completions,这是此处测试的设置。UberLLM 也提供 Responses API。
- 点击 验证连接,然后 保存。仅保存不会进行任何测试。
UberLLM 列出了大约 450 个模型,包括不具备聊天功能的图像和视频模型。如果没有 Model IDs 列表,所有模型都会出现在菜单中,并且每次页面加载都会等待完整列表加载完毕,因此请添加一个允许列表 (或开启 缓存基础模型列表)。
使用 Docker 环境变量进行设置
docker run -d -p 3000:8080 \
-e OPENAI_API_BASE_URLS="https://api.uberllm.dev/v1" \
-e OPENAI_API_KEYS="ull_your-key" \
-e OPENAI_API_CONFIGS='{"0":{"prefix_id":"uberllm","model_ids":["deepseek/deepseek-v4.1-flash","google/gemini-2.5-flash","z-ai/glm-5.2"]}}' \
-v open-webui:/app/backend/data --name open-webui ghcr.io/open-webui/open-webui:main
这些变量仅在首次启动时被读取。此后,保存在 Open WebUI 数据库中的值将优先,除非你设置了 ENABLE_PERSISTENT_CONFIG=False。如果你已经运行了 Open WebUI,请改用管理界面。
直接连接 (每个用户自带密钥)
- 管理员在 Settings → Admin → Connections 下开启 直接连接 (或设置
ENABLE_DIRECT_CONNECTIONS=true)。 - 每个用户打开 User Settings → Connections,点击 +,并输入 Base URL
https://api.uberllm.dev/v1和他们自己的 API Key。
通过直接连接,用户的浏览器直接调用 UberLLM,并且密钥保留在该浏览器中。UberLLM 允许这些浏览器调用。
推荐模型
在 2026年10月30日 经 UberLLM 检查。
| 模型 ID | 上下文 | 备注 |
|---|---|---|
deepseek/deepseek-v4.1-flash |
1,048,576 | 快速;先推理再回答 |
google/gemini-2.5-flash |
1,048,576 | 可读取图片 |
qwen/qwen3-vl-235b-a22b-instruct |
256,000 | 可读取图片,无需推理步骤直接回答 |
常见错误
| 您看到什么 | 原因和解决方法 |
|---|---|
Verify Connection 失败并显示 401 |
API 密钥缺失或输入错误。 |
| 未显示模型 | URL 包含尾部斜杠或有拼写错误。它必须是 https://api.uberllm.dev/v1。 |
| 模型菜单或页面加载缓慢 | 没有 Model IDs 允许列表:参见上文。 |
| 来自其他连接的模型消失了 | 两个连接返回了相同的无前缀 ID,Open WebUI 保留了一个。设置 Prefix ID。 |
402 insufficient_credits |
余额不足。在 Dashboard → Credits 中充值。 |