集成指南/OpenWebUI 接入
把 UniGateway 作为 OpenWebUI 的 OpenAI 兼容后端接入。
如果你在 OpenWebUI 中使用 OpenAI 兼容连接，可以直接把 UniGateway 作为后端接入。
基础配置#
- Endpoint Base：
https://api.unigateway.ai/v1
- API Key：你的 UniGateway bearer token
- 模型 ID：从
GET /v1/models 实时读取
推荐上线顺序#
- 先创建一条指向 UniGateway 的 OpenAI 兼容连接。
- 先用一个稳定模型 ID 验证模型发现是否正常。
- 先测试一个简短对话，再逐步放开长对话或共享工作区。
- 流式、图片、音频等能力都要独立验证，不要混在聊天通过里默认放行。
运行建议#
| 项目 | 建议 |
|---|
| 模型刷新 | 模型目录变化后重新同步，不要长期依赖缓存列表 |
| 共享部署 | staging 和 production 使用不同 key |
| 高级能力 | tools、files、多模态路由逐项验证 |
| 默认模型 | 先只放一个稳定默认模型，后续再扩 |
常见问题#
| 问题 | 处理方式 |
|---|
| 连接能保存但看不到模型 | 检查 key 权限，并直接确认 /v1/models 可用 |
| 聊天正常但流式不稳定 | 把 streaming 当成单独兼容门禁 |
| 不同工作区行为不一致 | 检查是否存在环境级缓存配置或重复连接 |