Open WebUI 接入 kkaiapi

最后更新:

在 Open WebUI 添加 OpenAI 兼容连接,核对服务器出口、模型列表与访问权限,区分聊天模型和知识库 embedding 配置。

在服务端添加 OpenAI 兼容连接

管理员在 Admin Panel → Settings → Connections 的 OpenAI API 连接中添加 KK 地址与 Key,保存后刷新模型列表。若使用个人直连,先核对部署是否允许 Direct Connections;不要把管理员共享 Key 暴露给普通用户。

配置项值
连接类型OpenAI-compatible
URLhttps://api.kkaiapi.com/v1
API Key管理员安全保存的 KK Key
先选择的聊天模型claude-sonnet-5-5

保存后验证一次聊天请求

配置完成后用一个短任务核对实际模型 ID 与 KK 调用记录,再单独验证工具往返、图片输入等所需能力。聊天成功只能证明该聊天路径可用。

import os
from openai import OpenAI

client = OpenAI(api_key=os.environ["KKAI_API_KEY"],
                base_url="https://api.kkaiapi.com/v1", max_retries=0, timeout=120)
r = client.chat.completions.create(
    model="claude-sonnet-5-5",
    messages=[{"role": "user", "content": "请只回复 pong"}],
)
print(r.choices[0].message.content)

核对实际生效的工具路径

从运行 Open WebUI 的容器或服务器核对网络出口;浏览器能访问不代表服务端能访问。模型列表异常先检查连接启用、访问权限和 Key 模型限制,再按精确 ID 选择。知识库还需要单独配置 embedding 模型,聊天连接不自动补齐。

配置依据与能力验证

配置完成后用一个短任务核对实际模型 ID 与 KK 调用记录,再单独验证工具往返、图片输入等所需能力。聊天成功只能证明该聊天路径可用。

配置字段依据openwebui 官方说明;工具界面可能随版本变化,所需能力应在已安装版本中核对。

常见问题

为什么 API 请求成功,工具仍不能完成任务?

继续核对工具实际选择的 provider、模型、能力声明和运行进程的网络出口;工具调用、文件编辑和图片入口应分别验证。