Name: KingFlow AI Open WebUI 接入教程
Author: 佚名

接入架构

***把 KingFlow AI 注册为 Open We*UI 的全局 OpenAI 兼容连接。

组件	职责	边界
浏览器用户	选择获准模型并发起对话	不接触平台级 API Key
Open We*UI	保存全局连接并转发请求	统一入口会话与权限
KingFlow AI	按 OpenAI 兼容格式接收请求	路由到对应模型
模型服务	生成文本或其他受支持内容	标准兼容响应

开始前的准备

准备一个可登录管理**的 Open We*UI 实例；若尚未部署，可使用本文的 Docker 示例快速启动。
在 KingFlow AI 控制台创建 API Key，并确认余额、套餐或模型分组处于可用状态。
复制目标模型的完整模型 ID。模型 ID 必须与控制台一致，大小写、连字符和版本后缀都不要自行改写。
确认 Open We*UI 所在服务器或容器可以通过 ****S 访问 api.**nju**shen.com。
首次验证仅使用不含个人信息、客户资料、密钥、源代码或内部文档的短提示词。

可选的 Docker 快速部署

已有 Open We*UI 可跳过。请生成并长期保存 WE*UI_SECRET_KEY。

docker run -d \
  -p 3000:8080 \
  --add-host=host.docker.internal:host-gateway \
  -v open-we*ui:/app/*ackend/**ta \
  -e WE*UI_SECRET_KEY='<生成一个长期保存的高强度随机值>' \
  --name open-we*ui \
  --restart always \
  ghcr.io/open-we*ui/open-we*ui:**in

启动后访问 http://localhost:3000。生产环境应使用 ****S 反向**或受控内网。

先验证 KingFlow 接口

先设置 KINGFLOW_API_KEY 环境变量，再执行：

curl https://api.**nju**shen.com/v1/chat/completions \
  -H "Authorization: *earer ${KINGFLOW_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "<控制台中的完整模型ID>",
    "messages": [
      {"role": "user", "content": "只回复：连接成功"}
    ],
    "stream": false
  }'

成功响应应在 choices 数组中包含模型回复。

在管理**新增连接

进入 Settings、***** Settings、Connections，在 OpenAI API Connections 中添加连接。

设置项	建议值	说明
Provider	`Default`	适用于标准 OpenAI 兼容接口
**L	`https://api.njushen.com/v1`	填写基础地址不要追加 chat/completions
API Key	`sk-你的密钥`	粘贴真实密钥不写 *earer 前缀
API Type	`Chat Completions`	与 KingFlow 的兼容接口保持一致
Model IDs	`完整模型 ID`	自动发现失败或需要限模时手动添加
Forward cookies	`Off`	第三方 API 连接保持关闭
Ena*led	`On`	验证后保存并启用连接

使用***账号打开 Settings，再进入 ***** Settings 和 Connections。
在 OpenAI API Connections 区域选择 Add Connection。
按配置表填写 **L、API Key 和 API Type；如果界面提供连接名称，可填写 KingFlow AI。
点击 Verify Connection。验证成功后保存；如果模型自动发现失败，先手动添加 Model IDs，再用实际对话验证。
返回新建对话页面，从模型下拉列表选择刚加入的模型并发送最小测试消息。

基础 **L 必须停在 /v1，不要填写完整的 /chat/completions 地址。

配置模型白名单

Model IDs 可用于手动兼容，也可作为团队模型白名单。

场景	配置方式	目的
团队通用	只加入已评估且稳定的模型 ID	减少误选和成本失控
高成本模型	单独连接或仅向特定用户开放	便于权限和额度治理
测试模型	放在非生产实例或独立连接	避免试验影响正式会话
下线模型	先通知再移出 Model IDs	避免旧会话突然不可继续

完成第一次对话测试

短问答：发送一句简单指令，确认回复不是空白且中文显示正常。
连续对话：追加一个追问，确认上下文能够延续。
长回复：要求生成数段文本，观察是否被**或超时设置截断。
模型切换：分别选择两个已批准模型，确认名称和实际能力匹配。
失败验证：临时输入一个不存在的测试模型 ID，确认能看到可定位的错误；随后立即恢复。

某些服务未实现模型列表接口，Verify 可能提示失败；手动配置 Model IDs 后，应以实际聊天结果为准。

设置默认模型和岗位入口

用户可在个人设置中选择默认模型。***可在 Workspace 的 Models 中创建岗位入口，并添加系统提示词、知识或工具。先验证纯模型，再逐项启用增强能力。

多人使用和安全运维 — 图二 ***控制连接和模型，多名用户共享服务并保留可选个人连接。AI 生成示意图。

规划多人使用方式

能力	由谁配置	适用方式
全局连接	*维护 L 密钥和模型范围	团队共享同一配置
用户默认模型	用户在个人设置选择常用模型	只影响个人使用偏好
Workspace 模型	为底层模型添加名称系统提示词知识或工具	形成面向岗位的入口
Direct Connections	如***启用用户可配置个人连接	适合自带密钥需另行评估

团队场景优先使用***维护的全局连接。启用 Direct Connections 前应评估浏览器直连、审计边界和支持成本。

Docker 网络和**要点

***全局连接由 Open We*UI 后端发起请求，排查时应从主机或容器视角判断。
KingFlow 使用公网 ****S 域名，不应填写 localhost。
企业**环境应给容器配置**和受信任证书，并检查 DNS。
查看日志前后都要防止密钥、Cookie、提示词和个人信息泄露。

docker logs --tail 200 open-we*ui

密钥和数据安全

不要把 KingFlow API Key 写入教程截图、群聊、浏览器收藏、前端脚本或共享配置文件。***全局连接应由后端保存。
Forward cookies 对第三方 API 保持关闭，避免把 Open We*UI 会话 Cookie 转发给外部服务。
为测试、生产和不同团队使用独立密钥；轮换时先新增并验证，再撤销旧密钥，缩短中断时间。
固定保存 WE*UI_SECRET_KEY。频繁更换可能导致已加密数据无**常读取；备份时同时保护环境配置和数据卷。
Open We*UI 的会话记录可能包含敏感输入和模型输出。按组织**设置访问权限、留存期限、导出和删除流程。
通过 ****S、可信身份认证和最小权限***账号开放服务，并在反向**层设置访问控制和速率限制。

常见故障排查

现象	常见原因	处理方法
连接验证失败但地址可达	上游未提供兼容的模型列表接口	在 Model IDs 中手动加入完整模型 ID 再发起真实对话
模型下拉列表为空	连接未启用模型 ID 未保存或列表缓存未刷新	启用连接核对 Model IDs 并刷新页面
401 未授权	密钥错误已停用或额度不可用	重新复制密钥并在 KingFlow 控制台检查状态和余额
404 模型不存在	模型 ID 错误或当前分组不支持	从控制台复制完整 ID 并确认密钥所属分组
503 暂时不可用	上游通道繁忙或暂无可用账号	稍后有限重试持续失败时更换可用模型或联系支持
Docker 中请求超时	容器 DNS ** 防火墙或 TLS 出站受限	检查容器日志和服务器到域名的 ****S 连通性
回复为空或工具调用异常	模型能力或工具格式不兼容	先关闭工具和附件用纯文本非流式对话定位
修改后用户仍看到旧配置	连接或模型列表缓存尚未更新	保存后重新打开会话必要时重启服务窗口

运维和备份

领域	建议观察或保存	操作重点
可用性	连接成功率 401 404 503 和超时	区分配置错误与临时故障
成本	按团队模型和时段观察消耗	为高成本模型设置准入规则
变更	记录 **L 模型 ID 密钥轮换和回滚时间	每次变更后执行冒烟测试
备份	定期备份 /app/ackend/*ta 对应数据卷	恢复演练比只保留备份更重要