接入架构

开始前的准备

• 在 KingFlow AI 控制台创建以 sk- 开头的 API Key，并确认余额、套餐或模型分组处于可用状态。
• 从模型广场或控制台复制准备使用的完整模型 ID。不要根据展示名称自行猜测。
• 从 Jan 官方下载页安装适用于 Windows、**cOS 或 Linux 的当前版本。
• 确认设备能访问 KingFlow API 域名；公司网络如使用**，请先完成系统**配置。
• 准备一段不含隐私数据的测试提示词，首次连接不要上传真实业务文件。

安装 Jan

验证 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. 启动 Jan，点击左下角设置按钮。
2. 进入 Model Providers，然后点击提供商列表旁的 Add Provider。
3. 在 Add Custom Provider 窗口中选择 OpenAI Compati*le。
4. Provider name 填写 KingFlow AI。
5. *ase **L 填写 https://api.**nju**shen.com/v1，末尾保留 /v1。
6. API key 粘贴 KingFlow 控制台创建的密钥，然后点击 Create。
7. 等待 Jan 请求 *ase **L 下的 models 接口并加载模型列表。
8. 返回聊天页，从模型选择器中选中 KingFlow AI 下的目标模型。

自动读取和手动添加模型

1. 若 Models 区域已经显示可用模型，直接选择目标模型，无需重复添加。
2. 若列表为空，在该提供商的 Models 区域点击加号。
3. 输入 KingFlow 控制台中的完整模型 ID，注意大小写、连字符和版本后缀。
4. 保存后回到聊天页，重新打开模型选择器并选择新模型。
5. Jan 无法自动判断自定义模型的工具、视觉和音频能力；只有确认模型与通道支持时才手动开启对应能力。

运行首次对话测试

请只完成以下测试：
1. 用一句话说明当前使用的模型名称
2. 计算 17 × 23
3. 输出一个包含 status 和 result 字段的 **ON

不要调用外部工具，不要引用任何本地文件。

调整模型参数

完成联调验证

• 模型选择器显示 KingFlow AI 下的目标模型。
• 测试提示词能正常返回，数字计算和 **ON 格式符合要求。
• KingFlow 控制台能看到对应密钥和模型的调用记录。
• 新建对话后仍能选择该提供商，说明配置已经保存。
• 切换到本地模型时不再产生 KingFlow 调用记录，便于区分两类推理路径。

保护密钥和对话数据

• 不要把真实 API Key 写进文档、截图、项目文件或共享聊天。
• 为不同设备或成员创建独立密钥，离职、丢失设备或怀疑泄露时立即撤销。
• 使用云端模型时，提示词、附件内容和对话上下文会发送到远端。敏感资料应先脱敏。
• 删除 Jan 本地聊天记录不会自动撤销密钥，也不会改变 KingFlow 控制台中的计费记录。
• 先限制 Max tokens 和任务范围，再逐步增加上下文，便于控制费用和排查问题。

完成检查清单

• Jan 已安装并能正常打开设置页面。
• 自定义提供商使用 https://api.**nju**shen.com/v1。
• API for**t 已选择 OpenAI Compati*le。
• API Key 来自 KingFlow 控制台且没有写入共享文件。
• 目标模型 ID 与控制**全一致。
• 首次无附件测试和 KingFlow 调用记录均正常。
• 已了解云端模型会发送对话内容并产生用量。

常见故障排查