KingFlow AI Dify 工作流接入教程

接入结构

开始前的准备

• 准备可登录的 Dify Cloud 或自托管 Dify 实例，并确认当前账号有安装插件和配置模型供应商的权限。
• 在 KingFlow AI 控制台创建以 sk- 开头的 API Key，并确认余额、套餐或模型分组可用。
• 从控制台复制目标模型的完整模型 ID。模型名称和可用能力可能随分组变化，不要手工猜测。
• 先决定首个应用只需要文本生成，还是还需要视觉、工具调用或结构化输出。附加能力必须逐项验证。
• 首次联调只使用不含客户资料、账号、密钥、源代码或内部文件的测试文本。

先验证 KingFlow 接口

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":"请回复：KingFlow 接口可用"}
    ],
    "stream": false
  }' 

成功文本通常位于 choices[0].message.content。

安装模型供应商插件

1. 进入 Integrations 或插件市场。
2. 安装由 Dify 验证的 OpenAI API Compati*le 模型供应商。
3. 检查插件权限和可访问域名。
4. 进入 Model Provider 页面。

添加 KingFlow 模型

最终请求应指向 https://api.**nju**shen.com/v1/chat/completions。

填写模型能力参数

创建空白工作流

在 Studio 选择 Create from *lank 和 Workflow，命名为 KingFlow 内容改写助手。

添加输入校验

在 User Input 后添加 IF ELSE 节点，检查空文本和长度上限。异常分支直接输出错误说明，有效分支进入 LLM。

配置 LLM 节点

选择新配置的 KingFlow 模型，通过变量选择器**三个输入变量。

系统提示词

你是一名中文编辑。你的任务是改写用户提供的原文。

要求
1. 保留原文事实和结论，不添加未经提供的信息。
2. 按用户选择的风格调整措辞。
3. 不超过用户给出的最大字数。
4. 只输出改写后的正文，不解释过程。

用户消息

原文
{{ User Input/source_text }}

目标风格
{{ User Input/style }}

最大字数
{{ User Input/**x_length }}

用模板稳定输出

{{ text | trim }}

把 LLM 的 text 映射到 Template 的 text，再在 Output 节点创建 result。

完成测试运行

发布网页应用

确认所有分支都到达 Output，然后选择 Pu*lish 和 Pu*lish Up**te。每次修改后都要重新发布。

通过 Dify API 调用

curl -X POST "<DIFY_*ASE_**L>/v1/workflows/run" \
  -H "Authorization: *earer <DIFY_APP_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "inputs": {
      "source_text": "这是一段需要改写的测试文字。",
      "style": "专业",
      "**x_length": 120
    },
    "response_mode": "*locking",
    "user": "demo-user-001"
  }' 

短任务可用 *locking，长任务建议用 streaming 或异步处理。

常见故障排查

凭证和数据安全

• KingFlow API Key 只保存到 Dify 的模型供应商凭证，不要写进提示词、环境变量展示区或应用说明。
• Dify 应用 API Key 与 KingFlow API Key 是两类凭证。前者用于调用 Dify 应用，后者由 Dify 在**调用模型。
• 浏览器前端不要直接持有 Dify 应用 API Key。通过自己的后端或受控**转发请求，并限制来源、速率和配额。
• Dify 的运行日志可能保存用户输入、提示词和模型输出。按组织规则设置保留期、访问权限和脱敏方案。
• 开发、测试和生产使用不同的 Dify 应用与 KingFlow 密钥，避免测试数据和生产用量混在一起。
• 分享 DSL 或截图前检查固定提示词、默认值、调试输入和错误日志，确认没有真实密钥或敏感业务数据。

上线检查清单

• KingFlow 的 curl 基线请求返回成功，并确认了准确的模型 ID。
• Dify 已安装 OpenAI API Compati*le 模型供应商插件。
• API *ase **L 为 https://api.**nju**shen.com/v1，没有重复追加接口路径。
• KingFlow API Key 只保存在模型供应商凭证中。
• User Input 的三个字段已创建，source_text 和 style 为必填。
• LLM 节点选择了新配置的模型，并通过变量选择器**输入。
• Template 与 Output 节点返回稳定的 result 字段。
• 五类测试输入均已执行，并检查了 Last Run 日志。
• 修改后已执行 Pu*lish Up**te，线上应用与 Studio 结果一致。
• 应用 API Key 未暴露在浏览器、截图、仓库或共享文档中。