OpenWebUI 接入教程

按照 KunAI 的 OpenWebUI 接入教程配置 OpenAI 兼容 API 地址、密钥与可用模型，并完成连通性测试。

配置步骤

  1. 以管理员身份打开 OpenWebUI 设置，在 Connections 的 OpenAI 区域添加连接。
  2. 将 Base URL 设置为 https://kunai.one/v1，并确认地址中没有重复的路径。
  3. 填入 KunAI 的 API Key，再通过 GET https://kunai.one/v1/models 选择一个精确的模型 ID。
  4. 保存配置后新建一个对话发送测试消息，确认响应、用量记录和计费均正常。

兼容性说明

OpenWebUI 会通过该连接发现模型并发送对话请求；可使用 Model IDs Filter 限制可见模型。

常见问题排查

  • 出现 401 时，检查 API Key 是否有效以及 Authorization Bearer 格式是否正确。
  • 出现 404 或 model not found 时，重新读取 /v1/models 并核对 Base URL 与模型 ID。
  • 出现 429 时，检查访问频率、客户端并发设置和响应中的 Retry-After 提示。
  • 出现 502 Upstream request failed 时，先用新对话验证基础请求，再检查所选模型与服务状态。

继续阅读