Skip to content

Open WebUI 接入自定义 API ​

在 Open WebUI 的管理员设置 Connections 中添加一个 OpenAI API 连接:URL 填 https://api.niceai.dev/v1,API Key 填 NiceAI 密钥,保存后在聊天页选择模型即可。用 Docker 部署时也可以通过环境变量一次配好。

准备工作 ​

  1. 已部署 Open WebUI,并使用管理员账号登录。
  2. 在 NiceAI 控制台「API 密钥」页面创建密钥,分组按要用的模型选择。

配置步骤 ​

  1. 进入 设置 → Connections(管理员区域),找到 Manage OpenAI API Connections。
  2. 点击 Add Connection。
  3. URL 填 https://api.niceai.dev/v1,API Key 填 NiceAI 密钥。
  4. 点击 URL 旁的 Verify Connection 测试连接,保存。
  5. 回到聊天页,在模型选择器中选择模型。

验证失败也不一定不能用

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 中只保留你要用的模型,列表会清爽很多。

下一步 ​

NiceAI · 稳定的 AI 大模型 API 中转站