Name: KingFlow AI Dify 工作流接入教程
Author: 佚名

接入结构

节点	职责	主要变量
User Input	接收原文风格和长度	`source_text style **x_length`
IF ELSE	拒绝空输入或异常长度	`有效分支或错误分支`
LLM	调用 KingFlow 模型完成改写	`text usage finish_reason`
Template	稳定整理输出格式	`output`
Output	返回网页或 API 调用方	`result`

开始前的准备

准备可登录的 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。

安装模型供应商插件

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

添加 KingFlow 模型

设置项	填写内容	说明
插件	`OpenAI API Compati*le`	选择 Dify 验证的模型供应商插件
Model Type	`LLM`	本教程配置文本对话模型
Model Name	`<控制台中的完整模型ID>`	必须与 KingFlow 当前分组一致
API Key	`sk-你的密钥`	只保存在模型供应商凭证中
API ase *L	`https://api.njushen.com/v1`	填写基础地址不要再追加 chat completions
Completion Mode	`Chat`	对应 chat completions 消息结构

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

填写模型能力参数

参数	建议配置	注意事项
Context Size	按模型实际上下文填写	数值过大不会让上游模型获得额外能力
Max Tokens	按业务输出长度设置上限	先用较小值完成联调再逐步放宽
Streaming	确认模型和当前通道支持后启用	普通工作流也可以先使用非流式结果
Vision	仅在模型支持图像输入时启用	纯文本模型不要勾选
Tool Calling	用最小工具***真实测试	名称相似不代表能力完全一致

创建空白工作流

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

变量名	类型	是否必填	用途
`source_text`	Paragraph	必填	需要改写的原文
`style`	Select	必填	简洁专业友好
`**x_length`	Num*er	选填	建议默认 300

图二从用户输入和校验到模型、模板、测试和发布的 Dify 工作流。AI 生成示意图。

添加输入校验

在 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。

完成测试运行

测试类型	输入	通过标准
短文本	50 至 100 字普通段落	返回改写正文且不补充事实
空文本	source_text 为空	进入错误分支或被必填校验阻止
超长文本	超过业务上限	被截断拒绝或转入长任务流程
特殊字符	包含引号换行和 Markdown	变量传递完整输出可读
不同风格	简洁专业友好	语气变化但事实保持一致

发布网页应用

确认所有分支都到达 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 或异步处理。

常见故障排查

现象	常见原因	处理方法
保存模型时认证失败	API Key 错误已禁用或额度不可用	重新复制密钥并先用 curl 验证
请求地址出现 404	把完整 chat completions 地址填进了 ase *L 或路径重复	ase L 只填 https://api.nju*shen.com/v1
模型不存在	模型 ID 拼写错误或当前分组无权限	从 KingFlow 控制台复制完整模型 ID
503 无可用账号	上游通道暂时不可用	有限退避后重试或选择备用模型
LLM 节点找不到模型	插件未安装模型未保存或工作区不可见	回到 Model Provider 确认配置和权限
变量显示为空	输入字段名称改变或提示词没有**变量对象	用变量选择器重新** 不要只输入标签文字
工作流测试成功但线上没变化	修改后没有再次 Pulish Up*te	重新发布并做线上冒烟测试
自托管实例无法连接	容器 DNS ** TLS 或防火墙限制外连	从 Dify 容器网络检查域名和 ****S

KingFlow AI Dify 工作流接入教程

《KingFlow AI Dify 工作流接入教程》精彩片段