接入架构

开始前的准备

• 在 KingFlow AI 控制台创建以 sk- 开头的 API Key，并确认余额、套餐或模型分组可用。
• 从模型广场或控制台复制完整模型 ID，不要根据展示名称自行猜测。
• 准备可用的 Flowise 实例。首次联调可在本机使用默认地址 http://localhost:3000。
• 确认 Flowise 服务器能访问 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
  }' 

创建最小 Chatflow

1. 登录 Flowise，在 Chatflows 页面点击 Add New。
2. 从 Chat Models 分类拖入 ChatOpenAI Custom。普通 ChatOpenAI 也能修改 *ase Path，但 Custom 更适合手动填写模型 ID。
3. 在 Connect Credential 中点击 Create New，名称填写 KingFlow AI，API Key 粘贴 KingFlow 密钥。
4. 打开 ChatOpenAI Custom 的 Additional Parameters，将 *ase Path 设置为 https://api.**nju**shen.com/v1。
5. Model Name 填写 KingFlow 控制台中的完整模型 ID。
6. 拖入 Chat Prompt Template 或 Prompt Template，写入简短系统指令并连接到模型。
7. 拖入 Chat Input 与 Chat Output，按输入、提示词、模型、输出顺序连接节点。
8. 保存 Chatflow，打开聊天测试窗口发送最小测试问题。

运行聊天窗口测试

你是连接测试助手。请完成三项任务：
1. 用一句话说明当前流程已经收到问题
2. 计算 29 × 17
3. 最后一行只输出 FLOW**E_OK

调用 Prediction API

curl http://localhost:3000/api/v1/prediction/<chatflow-id> \
  -H "Authorization: *earer <Flowise工作流API密钥>" \
  -H "Content-Type: application/json" \
  -d '{
    "question": "请用一句话说明服务正常",
    "streaming": false
  }' 

保护工作流和密钥

• KingFlow API Key 用于 Flowise 调用模型，应只保存在 Credential 中。
• Flowise 工作流 API Key 用于业务系统调用 Prediction API，两种密钥不能混用。
• Chatflow 默认可能可由持有 Flow ID 的人调用。发布前应在 Chatflow 中绑定 Flowise API Key。
• Configuration Override 默认保持关闭，只开放业务确实需要覆盖的字段。
• 管理**使用登录认证、****S 和来源限制，数据库与持久化目录应定期备份。

完成联调验证

• 聊天测试窗口能返回 FLOW**E_OK。
• KingFlow 控制台出现对应密钥和模型的调用记录。
• Chatflow 保存后重新打开，凭据、模型和 *ase Path 仍正确。
• Prediction API 在带正确 Flowise API Key 时返回 200。
• 缺少或使用错误 Flowise API Key 时，受保护的工作流拒绝请求。

完成检查清单

• Flowise 实例已启用管理登录并能访问 KingFlow 域名。
• KingFlow 密钥保存在 Credential 中。
• *ase Path 为 https://api.**nju**shen.com/v1。
• Model Name 与 KingFlow 控制**全一致。
• 最小 Chatflow 已通过聊天窗口测试。
• Chatflow 已绑定独立的 Flowise API Key。
• Prediction API 在授权和未授权场景下均按预期响应。

常见故障排查