Quartz 4

text-to-image-workflow

8 min read

📋 工作流概述

工作流名称：文生图（netmicro-novel-external-book）  

功能：根据文本描述生成图片，支持自定义尺寸和生成数量  

文件：文生图（netmicro-novel-external-book）.yml

🔄 工作流结构


开始节点 → API工具节点（generateImage） → 代码处理节点 → 结束节点

节点说明

| 节点 | 类型 | 功能 | 说明 |

|------|------|------|------|

| 开始 | start | 接收用户输入 | 输入图片描述和参数 |

| generateImage | tool | 调用文生图API | 调用”书城”工具的generateImage接口 |

| 处理响应结果 | code | 处理API响应 | 提取图片URL并格式化输出 |

| 结束 | end | 返回结果 | 输出格式化的图片信息 |

📥 输入参数

必填参数

| 参数名 | 类型 | 说明 | 限制 |

|--------|------|------|------|

| prompt | 文本 | 图片描述 | 最多1000字符 |

可选参数

| 参数名 | 类型 | 说明 | 默认值 | 范围 |

|--------|------|------|--------|------|

| model_name | 文本 | 模型名称 | 已固定为 imagen-4.0-fast-generate-preview-06-06 | - |

| width | 数字 | 图片宽度 | - | 256-2048 |

| height | 数字 | 图片高度 | - | 256-2048 |

| num_images | 数字 | 生成数量 | 1 | 1-4 |

| creator | 文本 | 创建人标识 | - | - |

📤 输出结果

输出字段

  • result（字符串）：格式化的图片信息文本

输出内容示例


✅ 图片生成成功！

  

📸 **图片信息**

- 图片链接: https://media.novelflow.app/test/text-to-image/xxx.png

- 尺寸: 1024 x 1024 像素

- 格式: PNG

- 文件大小: 0.50 MB

- 生成耗时: 3.50 秒

  

📝 **生成参数**

- 提示词: A beautiful sunset over the ocean

- 模型: imagen-4.0-fast-generate-preview-06-06

  

🔗 **图片链接**

https://media.novelflow.app/test/text-to-image/xxx.png

  

💡 **提示**: 您可以直接点击链接查看或下载图片

🔧 配置说明

API工具配置

  • 工具名称：书城

  • 工具调用名称：generateImage

  • Provider ID：c5e71e71-e337-49f4-a7ab-c63d21441c01

  • 认证方式：Header认证（X-AppName: NovelFlow）

参数映射

| API参数 | 来源 | 类型 | 说明 |

|---------|------|------|------|

| prompt | 开始节点.prompt | variable | 图片描述 |

| modelName | 固定值 | mixed | imagen-4.0-fast-generate-preview-06-06 |

| width | 开始节点.width | variable | 图片宽度（可选） |

| height | 开始节点.height | variable | 图片高度（可选） |

| numImages | 开始节点.num_images | variable | 生成数量（可选） |

| creator | 开始节点.creator | variable | 创建人（可选） |

💻 代码节点说明

功能

处理API响应，提取图片URL和信息，格式化输出。

输入

  • api_response：API工具节点的json输出（Array[Object]）

输出

  • result：格式化的结果文本

  • image_url：图片URL

  • success：是否成功（布尔值）

  • image_info：图片详细信息对象

处理逻辑

  1. 检查响应格式（支持数组或对象）

  2. 提取json字段

  3. 检查响应状态码（code === 200）

  4. 提取图片数据（data字段）

  5. 格式化输出结果

  6. 错误处理和调试信息

📝 使用步骤

1. 导入工作流

  1. 登录Dify平台

  2. 进入 工作流 → 导入

  3. 上传 文生图（netmicro-novel-external-book）.yml 文件

2. 配置API工具（如果未配置）

  1. 确认”书城”工具已导入

  2. 检查工具认证配置（X-AppName: NovelFlow）

  3. 确认服务器地址正确

3. 运行工作流

  1. 打开工作流

  2. 点击 运行 或 测试

  3. 输入参数：

   - prompt：图片描述（必填）

   - width：图片宽度（可选）

   - height：图片高度（可选）

   - num_images：生成数量（可选）

   - creator：创建人（可选）

  1. 点击运行

4. 查看结果

  • 结果会显示格式化的图片信息

  • 包含图片链接、尺寸、格式等信息

  • 可以直接点击链接查看或下载图片

⚠️ 注意事项

1. 工具配置

  • ✅ 确保”书城”工具已正确配置

  • ✅ 确认认证Header（X-AppName: NovelFlow）已设置

  • ✅ 检查服务器地址是否正确

2. 参数要求

  • ✅ prompt 必须填写，最多1000字符

  • ✅ modelName 已固定，无需填写

  • ⚠️ width 和 height 必须在 256-2048 之间

  • ⚠️ num_images 必须在 1-4 之间

3. 错误处理

  • 如果API调用失败，代码节点会返回详细的错误信息

  • 包含调试信息，便于排查问题

4. 性能考虑

  • 图片生成通常需要 3-5 秒

  • 生成时间取决于图片尺寸和服务器负载

  • 建议先用小尺寸测试，确认满意后再生成大尺寸

🐛 常见问题

Q1: 提示”ModelName is required”

原因：modelName参数未正确传递

解决：检查工作流配置，确认modelName已设置为固定值

Q2: 提示”404 Not Found”

原因：API工具认证未配置或服务器地址错误

解决：

  1. 检查”书城”工具的认证配置

  2. 确认Header X-AppName: NovelFlow 已设置

  3. 检查服务器地址是否正确

Q3: 生成的图片质量不满意

建议：

  1. 优化prompt，添加更多细节描述

  2. 尝试不同的风格关键词

  3. 调整图片尺寸（通常更大的尺寸质量更好）

  4. 生成多张图片（num_images: 2-4），选择最好的

Q4: 工作流运行失败

排查步骤：

  1. 检查API工具节点是否正常

  2. 查看代码节点的错误信息

  3. 检查输入参数是否正确

  4. 查看Dify的运行日志

📊 工作流节点ID

| 节点 | ID | 说明 |

|------|-----|------|

| 开始 | 1753705000001 | 输入节点 |

| API工具 | 1766996450649 | generateImage工具 |

| 代码处理 | 1753705000003 | 响应处理节点 |

| 结束 | 1753705000004 | 输出节点 |

🔗 相关文档

📝 更新记录

  • 2025-12-29：初始版本

  - 创建文生图工作流

  - 配置API工具节点

  - 添加响应处理代码

  - 修复modelName默认值问题

  - 修复结束节点输出字段问题

💡 使用技巧

  1. Prompt优化

   - 使用具体、详细的描述

   - 包含风格、光线、构图等关键词

   - 保持在100-200字以内效果最佳

  1. 尺寸选择

   - 社交媒体：512x768（竖版）或 1024x512（横版）

   - 文章配图：1024x1024（方形）

   - 书籍封面：1024x1536（竖版）

  1. 批量生成

   - 设置 num_images: 3-4 生成多张图片

   - 选择最满意的一张使用

  1. 保存结果

   - 及时保存图片链接

   - 记录好用的prompt和参数组合

最后更新：2025-12-29

Graph View