图像生成节点

图像生成节点根据必填的文字提示词和可选参考图生成图片。它适合海报草图、产品概念图、场景图、角色设定图等生成任务，也可以通过输入变量把同一个画面模板用于不同业务数据。

节点只负责调用当前选择的图像模型并返回图片结果，不会自动保存图片到业务资源库，也不会替代内容审核、品牌规范检查或人工验收。

当前功能与旧文档差异

本页保留旧文档中仍然适用的模型设置、参考图、动态输入、提示词、输出和异常处理说明，并按当前系统修正以下内容：

• 当前线上模型由模型工厂动态提供。截图时可见的是 qwen-image 系列，不再使用旧文档固定列出的 Seedream 4.0、4.5、5.0 Lite；后续可用模型仍应以选择器实时结果为准。
• 当前属性面板只有一个必填的“提示词”编辑框，没有独立的“负向提示词”配置入口。旧数据结构中虽然仍保留 negative_prompt 字段，但不能把它当作当前可编辑功能。
• 当前宽高输入的前端范围是 512～4096，常用比例会自动换算为对应宽高；分辨率模式提供 1K、2K、3K、4K。模型是否接受某个组合，还要以单节点试运行结果为准。
• 当前最多生成图片数量范围为 1～15，默认 1；参考图最多可添加 15 项。当前前端没有实现“参考图数量与生成数量之和不得超过 15”的联合校验，因此不能照搬旧文档把它当作已验证规则。
• 当生成数量为 1 时，data 为 Image；大于 1 时，编辑器会自动把 data 改为 Array<Image>。
• 当前异常处理支持不重试或重试 1～3 次；旧文档只写“重试 1 次”已经不完整。
• 旧文档中的账号级固定并发 4、图片链接固定有效期 1 年等规则，没有出现在当前节点实现和配置面板中，本文不把它们作为现行承诺。

配置示例

示例选择当前空间可用的 qwen-image-3.0-pro，设置 16:9、1920×1080、最多生成 2 张图片。截图工作流只用于核对配置，没有执行生图，因此不会产生模型调用费用。

截图中只保留图像生成节点；开始与结束节点已经移到可见区域之外，避免与本节点配置混淆。

模型设置

配置	当前默认值	说明
模型	未选择	必须从当前空间可用的图像生成模型中选择。模型名称和能力标签由模型工厂动态返回。
联网搜索	关闭	开启后，模型可结合联网搜索结果生成图片。是否真正支持以及对时延、费用的影响取决于所选模型。
比例模式	宽高	可在“宽高”和“分辨率”之间切换，两种模式不会同时作为当前尺寸模式生效。
图片水印	关闭	控制是否要求生成结果带水印；具体水印样式由模型服务决定。
最多生成图片数量	1	整数范围 1～15。配置大于 1 时，应在提示词中明确图片数量和差异要求。

宽高模式

当前提供以下预设：

比例	自动宽高
16:9	1920×1080
3:2	1536×1024
4:3	1536×1152
1:1	1024×1024
3:4	1152×1536
2:3	1024×1536
9:16	1080×1920

选择预设比例后仍可修改宽和高。当前编辑器会把每个值限制在 512～4096，但这只是前端输入边界，不代表所有模型都支持范围内的任意尺寸。发布前应使用实际模型试运行目标尺寸。

分辨率模式

当前分辨率选项为 1K、2K、3K、4K，默认 2K。模型选择器会展示模型能力标签，但当前面板不会按每个模型动态裁剪这些分辨率选项；因此某个模型是否支持对应分辨率，仍以模型服务返回结果为准。

联网搜索和水印

联网搜索适用于提示词依赖近期公开信息的场景，例如近期商品外观或公开活动主题。普通风格图、概念图不必默认开启，以免增加时延和不可控外部信息。

“图片水印”开关表示向生成服务传递水印要求。当前界面没有承诺固定的水印文字、位置或样式；需要满足合规标识时，应试运行并验收最终图片，而不是只检查开关状态。

参考图

点击“参考图”右侧的加号可以增加参考图项，最多 15 项。每一项类型固定为 Image，可以：

• 上传本地图片；
• 引用开始节点或上游节点输出的 Image 变量。

参考图适合约束主体外观、色彩、风格或构图。参考图越多不一定越准确，应在提示词中说明每张图的用途，并确认所选模型具有“图片理解”或相应参考图能力。

新增参考图后不能为空，否则属性面板会显示“参考图不能为空”。不过当前工作流的节点专用发布校验只明确检查提示词，不能只依赖发布按钮发现所有空参考图问题。

上传图片前还应确认图片的使用授权和隐私要求，不要把包含密钥、个人隐私或未授权素材的截图作为参考图。

输入参数

“输入”用于定义提示词中的动态 String 参数。每项包含变量名和参数值，参数值可以是固定字符串，也可以引用上游 String 变量。

例如定义：

变量名	示例值
product_name	智能巡检机器人
scene	清晨的未来工厂
brand_color	蓝白色

提示词可写成：

{{scene}}中的{{product_name}}，主体使用{{brand_color}}，广角构图，真实材质，细节清晰

变量名应保持稳定且语义明确。不要把完整提示词拆成大量难以维护的短变量；通常只把会随每次运行变化的业务内容参数化。

提示词

提示词必填，是当前图像生成节点专用校验明确检查的字段。当前面板没有独立负向提示词输入框，应直接在同一个提示词中表达主体、环境、构图、风格和限制要求。

推荐按以下顺序组织：

1. 主体：画面中必须出现什么。
2. 环境：时间、地点、天气和背景。
3. 构图：景别、视角、主体位置和画幅方向。
4. 风格：摄影、插画、3D、工业设计等。
5. 光线与色彩：主色、光源、氛围。
6. 质量与限制：清晰度、材质细节，以及明确需要避免的元素。

当最多生成图片数量大于 1 时，还应明确每张图的差异，例如“生成 2 张：第一张为正面广角，第二张为侧面近景”。只修改数量而不写清多图要求，模型可能返回相似结果或不满足数量预期。

输出

节点输出字段只读：

输出	类型	说明
data	Image 或 Array<Image>	生成数量为 1 时是单张图片；大于 1 时自动变为图片数组。
msg	String	节点执行信息。不能只根据文本猜测成功状态，应结合运行状态和异常输出判断。

下游引用 data 前必须匹配类型：单图可以直接交给接受 Image 的节点，多图需要循环、批处理或显式选择数组元素。把 Array<Image> 直接传给只接受 Image 的字段会造成类型不匹配。

异常处理

设置	当前范围或选项	说明
整体执行超时	0.1～600 秒，默认 600 秒	超时后按当前异常处理方式继续。
重试次数	不重试、重试 1 次、2 次或 3 次	生成任务可能耗时较长，重试会增加时延和模型调用成本。
异常处理方式	中断流程、返回设定内容、执行异常流程	默认中断流程。

• 中断流程：节点失败后停止后续正常流程。
• 返回设定内容：不中断工作流，按合法 JSON 返回为当前输出字段准备的兜底内容。
• 执行异常流程：转到节点的异常分支，由后续节点记录、降级或通知。

启用非中断异常处理后，底层输出契约还会附加只读的 isSuccess（Boolean）和 errorBody（Object，包含 String 类型的 errorMessage、errorCode）。普通输出面板默认只显示 data 与 msg，不要因此忽略异常分支中的这两个字段。

重试并不适合所有错误。提示词为空、模型不支持尺寸、参考图类型错误或权限不足等确定性问题，应先修正配置；只有临时网络错误、服务繁忙等场景才适合有限重试。

工作流校验与发布前检查

当前节点专用校验函数只明确检查提示词是否为空，没有同时检查模型是否选择、参考图空项、输入参数完整性、尺寸是否被所选模型支持，也没有执行“参考图数量 + 生成数量”的联合限制。

因此发布前至少检查：

1. 已选择当前空间可用且能力匹配的图像模型。
2. 提示词非空，动态变量都已定义且能取得值。
3. 所有参考图项均已配置，图片来源有权限且可访问。
4. 目标宽高或分辨率已通过所选模型的单节点试运行。
5. 生成数量与下游 data 类型处理一致。
6. 对空结果、内容安全拦截、超时和模型服务错误配置了合理策略。
7. 不把“可以保存或发布”误认为实际生成必然成功。

推荐工作流

1. 先选择模型，使用固定提示词和默认 1 张图片完成单节点试运行。
2. 确认主体、构图和风格后，再调整比例、分辨率、水印和生成数量。
3. 需要参考图时逐张添加，并说明每张图对主体或风格的约束。
4. 将会变化的业务内容抽成 String 输入变量，在提示词中引用。
5. 为多图结果增加循环或批处理，并处理数组为空或数量不足。
6. 配置有限重试和异常分支，记录错误但不要泄露提示词中的敏感数据。
7. 发布前在实际入口核对图片质量、耗时、费用、合规标识和下游兼容性。

常见问题

为什么旧文档中的 Seedream 模型找不到？

模型列表已经改为从当前模型工厂动态加载。截图时线上提供的是 qwen-image 系列，未来还可能继续变化。应选择当前下拉框中的可用模型，不要按旧文档硬填模型名称。

为什么没有负向提示词输入框？

当前属性面板只提供一个必填提示词编辑框。需要表达排除项时，把它们写入同一提示词；不要依赖当前不可见的历史字段。

为什么把数量改成 2 后 data 类型变了？

这是当前编辑器的自动行为：数量为 1 时输出 Image，大于 1 时输出 Array<Image>。下游节点必须随之调整为数组处理。

为什么尺寸在前端可选，模型运行仍然失败？

前端提供的是通用尺寸范围和选项，不会针对每个模型动态裁剪。所选模型可能有更严格的像素、比例或分辨率限制，应以当前模型试运行结果为准。

可以通过循环节点批量生成吗？

可以，但要同时控制循环次数、单次生成数量、并发、费用和失败重试。当前文档没有证据继续承诺旧版固定并发 4，应以实际运行环境和模型服务限流为准。

生成图片会永久保存吗？

本节点返回图片结果，但当前节点面板没有承诺永久存储或固定有效期。重要图片应由后续业务流程保存到受控存储，并记录来源、权限和保留策略。