OpenWebUI 接入

OpenWebUI 通过管理界面保存 OpenAI-compatible 连接。开始前请准备 Lumoswitch Base URL、Access Key 和对外模型名称。

添加连接

1. 使用管理员账号登录 OpenWebUI。
2. 打开管理员设置中的连接或 OpenAI API 配置页面。
3. 新增 OpenAI-compatible 连接。
4. Base URL 填写 https://your-gateway.example.com/v1。
5. API Key 填写 Lumoswitch Access Key。
6. 保存并刷新模型列表。

Lumoswitch 控制台生成的环境变量形式为：

OPENAI_API_BASE_URL=https://your-gateway.example.com/v1
OPENAI_API_KEY=your-lumoswitch-access-key

选择模型

模型列表中应出现配置 API 暴露的对外模型名称。不要选择或手动填写上游真实模型 ID。

安全建议

• 只有管理员应能查看或修改连接凭证。
• 不要在截图、浏览器控制台或公开 Compose 文件中暴露 Access Key。
• 多个环境应使用不同配置 API 和 Access Key。

常见问题

• 模型列表为空：先用同一 Key 调用 /models，然后重新加载 OpenWebUI 模型列表。
• 保存后仍请求旧地址：重启 OpenWebUI，并检查是否存在重复连接。
• 连接测试 404：检查 Base URL 是否包含且只包含一次 /v1。
• 流式消息停住：检查反向代理是否缓冲 SSE 响应。