Appearance
图像生成节点
图像生成节点根据必填的文字提示词和可选参考图生成图片。它适合海报草图、产品概念图、场景图、角色设定图等生成任务，也可以通过输入变量把同一个画面模板用于不同业务数据。
节点只负责调用所选图像模型并返回图片结果，不会自动保存图片到业务资源库，也不会替代内容审核、品牌规范检查或人工确认。
配置要点
- 模型由模型工厂动态提供，应从模型选择器中选择可用图像模型。
- 属性面板使用一个必填的提示词输入框，不提供独立的负向提示词配置。
- 宽高范围为 512～4096；分辨率模式提供 1K、2K、3K、4K。
- 最多生成图片数量范围为 1～15，默认 1；参考图最多可添加 15 项。
- 生成数量为 1 时，
data为 Image；大于 1 时，data为 Array<Image>。 - 异常处理支持不重试或重试 1～3 次。
配置示例
示例选择空间中可用的图像模型，设置 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 | 蓝白色 |
提示词可写成：
text
{{scene}}中的{{product_name}}，主体使用{{brand_color}}，广角构图，真实材质，细节清晰变量名应保持稳定且语义明确。不要把完整提示词拆成大量难以维护的短变量；通常只把会随每次运行变化的业务内容参数化。
提示词
提示词必填。面板没有独立负向提示词输入框，应直接在同一个提示词中表达主体、环境、构图、风格和限制要求。
推荐按以下顺序组织：
- 主体：画面中必须出现什么。
- 环境：时间、地点、天气和背景。
- 构图：景别、视角、主体位置和画幅方向。
- 风格：摄影、插画、3D、工业设计等。
- 光线与色彩：主色、光源、氛围。
- 质量与限制：清晰度、材质细节，以及明确需要避免的元素。
当最多生成图片数量大于 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，不要因此忽略异常分支中的这两个字段。
重试并不适合所有错误。提示词为空、模型不支持尺寸、参考图类型错误或权限不足等确定性问题，应先修正配置；只有临时网络错误、服务繁忙等场景才适合有限重试。
配置检查
保存前至少检查：
- 已选择空间中可用且能力匹配的图像模型。
- 提示词非空，动态变量都已定义且能取得值。
- 所有参考图项均已配置，图片来源有权限且可访问。
- 目标宽高或分辨率已通过所选模型的单节点试运行。
- 生成数量与下游
data类型处理一致。 - 对空结果、内容安全拦截、超时和模型服务错误配置了合理策略。
- 不把“可以保存或发布”误认为实际生成必然成功。
推荐工作流
- 先选择模型，使用固定提示词和默认 1 张图片完成单节点试运行。
- 确认主体、构图和风格后，再调整比例、分辨率、水印和生成数量。
- 需要参考图时逐张添加，并说明每张图对主体或风格的约束。
- 将会变化的业务内容抽成 String 输入变量，在提示词中引用。
- 为多图结果增加循环或批处理，并处理数组为空或数量不足。
- 配置有限重试和异常分支，记录错误但不要泄露提示词中的敏感数据。
- 发布前在实际入口核对图片质量、耗时、费用、合规标识和下游兼容性。
常见问题
为什么模型列表与其他环境不同？
模型列表由模型工厂动态加载，会随空间配置变化。应选择下拉框中可用的模型，不要在工作流中硬编码模型名称。
为什么没有负向提示词输入框？
属性面板只提供一个必填提示词编辑框。需要表达排除项时，把它们写入同一提示词。
为什么把数量改成 2 后 data 类型变了？
这是编辑器的自动行为：数量为 1 时输出 Image，大于 1 时输出 Array<Image>。下游节点必须随之调整为数组处理。
为什么尺寸在前端可选，模型运行仍然失败？
前端提供的是通用尺寸范围和选项，不会针对每个模型动态裁剪。所选模型可能有更严格的像素、比例或分辨率限制，应以模型实际返回结果为准。
可以通过循环节点批量生成吗？
可以，但要同时控制循环次数、单次生成数量、并发、费用和失败重试。并发限制以运行环境和模型服务的实际限流为准。
生成图片会永久保存吗？
本节点返回图片结果，但节点面板不承诺永久存储或固定有效期。重要图片应由后续业务流程保存到受控存储，并记录来源、权限和保留策略。