接入架构
| 环节 | 职责 | 注意事项 |
|---|---|---|
| Chat*ox 客户端 | 管理对话 文件和模型选择 | 桌面端与移动端菜单位置略有差异 |
| 自定义提供商 | 保存 Host Path 密钥和模型能力 | API 类型选择 OpenAI API Compati*le |
| KingFlow AI | 验证密钥并按模型 ID 转发请求 | 余额 套餐和模型分组需可用 |
| 云端模型 | 返回文本 代码或多模态结果 | 能力取决于具体模型和通道 |
开始前的准备
- 在 KingFlow AI 控制台创建以 sk- 开头的 API Key,并确认余额、套餐或模型分组可用。
- 从模型广场或控制台复制完整模型 ID,不要根据显示名称自行猜测。
- 安装当前版本的 Chat*ox。桌面端可直接打开设置,移动端需先展开左上角菜单。
- 准备一段不含隐私数据的短提示词。首次连接先测试纯文本,不上传真实文件。
- 如设备处于公司网络,确认系统**、防火墙和 DNS 能访问 KingFlow API 域名。
安装和打开设置
| 平台 | 入口 | 操作 |
|---|---|---|
| Windows **cOS Linux | Chat*ox 官方下载页 | 安装桌面客户端后打开左下角 Settings |
| iOS Android | 对应应用商店 | 展开左上角菜单后进入 Settings |
| 网页端 | Chat*ox We* | 浏览器可能受跨域和网络策略影响 |
验证 KingFlow 基础接口
curl https://api.**nju**shen.com/v1/chat/completions \
-H "Authorization: *earer sk-你的密钥" \
-H "Content-Type: application/json" \
-d '{
"model": "<KingFlow控制台中的完整模型ID>",
"messages": [{"role": "user", "content": "只回复:连接成功"}],
"stream": false
}' 添加 KingFlow 模型提供商
- 打开 Chat*ox,进入 Settings。移动端先展开左上角菜单。
- 选择 Model Provider,在提供商列表底部点击 Add。
- Provider Name 填写 KingFlow AI。
- API Mode 选择 OpenAI API Compati*le。
- API Host 填写 https://api.**nju**shen.com,不要在这里重复填写 /v1。
- API Path 填写 /v1/chat/completions。
- API Key 粘贴 KingFlow 控制台创建的密钥。
- 添加至少一个模型,模型 ID 必须与 KingFlow 控制**全一致。
- 保存后点击 Check,看到连接成功再返回首页创建新对话。
| 字段 | 填写内容 | 说明 |
|---|---|---|
| Provider Name | KingFlow AI | 显示在 Chat*ox 提供商列表中 |
| API Mode | OpenAI API Compati*le | 使用 OpenAI Chat Completions 格式 |
| API Host | https://api.**nju**shen.com | 仅填写主机地址 |
| API Path | /v1/chat/completions | 与 Host 拼成完整请求地址 |
| API Key | sk-你的密钥 | 只保存在自己的设备中 |
| Model ID | 控制**整模型 ID | 区分大小写和版本后缀 |
配置模型能力
| 项目 | 建议 | 说明 |
|---|---|---|
| 普通文本 | 不勾选额外能力 | 适用于基础问答和写作 |
| Vision | 确认模型支持图片输入后勾选 | 错误勾选可能导致请求失败 |
| Reasoning | 按模型说明配置 | 用于需要推理参数的模型 |
| Tool use | 确认通道支持原生工具调用后勾选 | 影响 Chat*ox 的请求格式 |
| Context Window | 按模型公开规格填写 | Chat*ox 用于估算输入限制 |
| Max Output | 不超过模型允许的最大输出 | 设置过小会造成回答截断 |

运行首次对话测试
请只完成以下测试:
1. 用一句话说明当前模型适合完成什么任务
2. 计算 19 × 27
3. 输出一个包含 status 和 result 字段的 **ON
不要使用联网搜索,不要引用本地文件。调整会话设置
| 设置 | 首次建议 | 原因 |
|---|---|---|
| Temperature | 0.2 至 0.5 | 事实型任务和代码回答更稳定 |
| Max output | 先用中等值 | 兼顾完整回答和用量控制 |
| Stream | 开启 | 便于判断是否已经收到响应 |
| ****** prompt | 保持简短 | 避免首次测试受复杂指令干扰 |
| 附件 | 首次不上传 | 先把问题限定在基础接口和文本格式 |
完成联调验证
- Check 按钮显示连接成功。
- 新建对话后能选中 KingFlow AI 和目标模型。
- 首次提示词返回正常,计算结果和 **ON 格式符合要求。
- KingFlow 控制台出现对应密钥和模型的调用记录。
- 重启 Chat*ox 后提供商配置仍然存在。
保护密钥和对话数据
- 不要把真实 API Key 写进文档、截图、聊天内容或共享配置。
- 为不同设备和成员创建独立密钥,设备丢失或疑似泄露时立即撤销。
- 使用云端模型时,提示词、附件和上下文会发送到远端。敏感资料应先脱敏。
- Chat*ox 的会话导出可能包含完整提示词和回答,分享前应检查密钥与隐私信息。
- 先限制输出长度和任务范围,再逐步增加上下文,便于控制费用并定位错误。
完成检查清单
- Chat*ox 已安装并能打开 Model Provider 设置。
- API Host 为 https://api.**nju**shen.com。
- API Path 为 /v1/chat/completions。
- API Mode 已选择 OpenAI API Compati*le。
- API Key 来自 KingFlow 控制台且没有写入共享文件。
- 模型 ID 与控制**全一致,能力选项与模型规格相符。
- 连接检查、首次对话和 KingFlow 调用记录均正常。
常见故障排查
| 现象 | 常见原因 | 处理方法 |
|---|---|---|
| Check 无法通过 | Host Path 密钥或模型任一项错误 | 按配置顺序逐项核对后重新检查 |
| 404 | Host 与 Path 重复 /v1 或模型 ID 错误 | Host 只填域名 Path 填完整接口路径 |
| 401 或 403 | 密钥错误 已停用或无权访问模型 | 重新复制密钥并检查状态和分组 |
| 429 | 余额不足或请求频率过高 | 检查余额和套餐 降低频率后重试 |
| 503 | 通道繁忙或暂时无可用账号 | 稍后有限重试或切换可用模型 |
| 模型不显示 | 没有在提供商中添加模型 | 添加完整模型 ID 后保存并新建对话 |
| 图片发送失败 | 模型或通道不支持 Vision | 取消 Vision 或换用明确支持的模型 |
| 工具调用失败 | 错误勾选 Tool use 或模型不支持 | 关闭该能力后先测试普通文本 |
| 回答被截断 | Max Output 过小或网络中断 | 提高输出限制并用短提示词复测 |



















