接入架构

开始前的准备

• 在 KingFlow AI 控制台创建以 sk- 开头的 API Key，并确认余额、套餐或模型分组可用。
• 从模型广场或控制台复制完整模型 ID，不要根据显示名称自行猜测。
• 安装当前版本的 Chat*ox。桌面端可直接打开设置，移动端需先展开左上角菜单。
• 准备一段不含隐私数据的短提示词。首次连接先测试纯文本，不上传真实文件。
• 如设备处于公司网络，确认系统**、防火墙和 DNS 能访问 KingFlow API 域名。

安装和打开设置

验证 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 模型提供商

1. 打开 Chat*ox，进入 Settings。移动端先展开左上角菜单。
2. 选择 Model Provider，在提供商列表底部点击 Add。
3. Provider Name 填写 KingFlow AI。
4. API Mode 选择 OpenAI API Compati*le。
5. API Host 填写 https://api.**nju**shen.com，不要在这里重复填写 /v1。
6. API Path 填写 /v1/chat/completions。
7. API Key 粘贴 KingFlow 控制台创建的密钥。
8. 添加至少一个模型，模型 ID 必须与 KingFlow 控制**全一致。
9. 保存后点击 Check，看到连接成功再返回首页创建新对话。

配置模型能力

运行首次对话测试

请只完成以下测试：
1. 用一句话说明当前模型适合完成什么任务
2. 计算 19 × 27
3. 输出一个包含 status 和 result 字段的 **ON

不要使用联网搜索，不要引用本地文件。

调整会话设置

完成联调验证

• 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 调用记录均正常。

常见故障排查