OpenWebUI 接入
在 OpenWebUI 中添加 UniGateway 作为 OpenAI 兼容连接。
前置条件
- OpenWebUI 实例已运行
- 已获取 UniGateway API Key
配置步骤
创建一条 OpenAI 兼容连接：
| 字段 | 值 |
|---|---|
| Endpoint Base | https://api.unigateway.ai/v1 |
| API Key | 你的 UniGateway Bearer Token |
| 模型 ID | 从 GET /v1/models 获取 |
验证
发送一条简短提示，确认模型和聊天功能正常。
注意事项
| 方面 | 推荐 |
|---|---|
| 模型刷新 | 目录变更后重新同步 |
| 共用部署 | 测试与生产使用不同 Key |
| 高级功能 | 逐一验证工具、文件、多模态路由 |
常见问题
| 问题 | 处理方式 |
|---|---|
| 连接保存但无模型出现 | 检查 API Key 权限，确认 /v1/models 可用 |
| 聊天正常但流式不稳定 | 将流式作为独立兼容项验证 |
| 工作区行为不一致 | 检查是否缓存了旧配置 |