外观
Open WebUI 接入自定义 API
在 Open WebUI 的管理员设置 Connections 中添加一个 OpenAI API 连接:URL 填 https://api.niceai.dev/v1,API Key 填 NiceAI 密钥,保存后在聊天页选择模型即可。用 Docker 部署时也可以通过环境变量一次配好。
准备工作
- 已部署 Open WebUI,并使用管理员账号登录。
- 在 NiceAI 控制台「API 密钥」页面创建密钥,分组按要用的模型选择。
配置步骤
- 进入 设置 → Connections(管理员区域),找到 Manage OpenAI API Connections。
- 点击 Add Connection。
- URL 填
https://api.niceai.dev/v1,API Key 填 NiceAI 密钥。 - 点击 URL 旁的 Verify Connection 测试连接,保存。
- 回到聊天页,在模型选择器中选择模型。
验证失败也不一定不能用
Verify Connection 会请求 /models 接口获取模型列表。如果验证失败或列表里没有想要的模型,可以在连接设置的 Model IDs 中手动添加 模型广场 里的模型名,点 + 后保存。
用 Docker 环境变量配置
bash
docker run -d -p 3000:8080 \
-e OPENAI_API_BASE_URL=https://api.niceai.dev/v1 \
-e OPENAI_API_KEY=sk-你的密钥 \
-v open-webui:/app/backend/data \
--name open-webui \
ghcr.io/open-webui/open-webui:main环境变量只在首次初始化时写入,之后以管理员界面里的设置为准。
哪些功能会用到 NiceAI
Open WebUI 对话走 /v1/chat/completions。RAG 的向量化(embeddings)、语音、生图等功能分别需要对应的接口,是否能通过 NiceAI 使用,取决于你的分组是否提供这些接口;不确定时可以让这些功能继续使用本地或其他服务。
常见问题
返回 404?
URL 要以 /v1 结尾。见 接口地址要不要加 /v1。
模型列表里出现很多用不了的模型?
在连接设置的 Model IDs 中只保留你要用的模型,列表会清爽很多。