QwenImageEditApi - ComfyUI Built-in Node Documentation

此节点使用 Qwen-Image 3.0 模型，在文本提示的引导下编辑或组合最多 3 张参考图像。您选择模型、提供提示和参考图像，节点将返回一张或多张生成的图像。

输入

参数	描述	数据类型	必需	范围
`model`	要使用的模型。此选择还包含文本提示、最多 3 个参考图像输入以及可选的负面提示。	DYNAMIC_COMBO	是	”qwen-image-3.0-pro" "qwen-image-3.0”
`size`	输出分辨率。“match input” 复用第一张参考图像的尺寸，“auto” 让模型选择具有相同宽高比的尺寸，“custom” 设置明确的宽度和高度。	DYNAMIC_COMBO	是	”match input" "auto" "custom”
`n`	要生成的图像数量，以批次形式返回。（默认值：1）	INT	否	1 到 6
`seed`	用于生成的种子。（默认值：42）	INT	否	0 到 2147483647
`prompt_extend`	是否使用 AI 辅助增强提示。（默认值：True）	BOOLEAN	否	True False
`watermark`	是否在结果中添加 AI 生成的水印。（默认值：False）	BOOLEAN	否	True False

两个模型共享相同的子参数。

参数	描述	数据类型	必需	范围
`prompt`	编辑指令。支持英文和中文，以及 @Image1 风格的输入图像引用。（默认值：""）	STRING	是	-
`negative_prompt`	描述应避免内容的负面提示。（默认值：""）	STRING	否	-

参数	描述	数据类型	必需	范围
`images`	可扩展插槽：连接 1 到 3 张参考图像（`image_1`、`image_2`、`image_3`）。在提示中按输入顺序以 @Image1、@Image2、@Image3 引用它们；批处理输入按每张图像计数一次。	IMAGE	是	1 到 3

当 size 设置为 “custom” 时显示。

参数	描述	数据类型	必需	范围
`width`	输出宽度。总像素面积必须在 512x512 到 2560x2560 之间；宽高比必须在 1:8 到 8:1 之间。（默认值：1024）	INT	是（当 `size` 为 “custom” 时）	256 到 2560, step 16
`height`	输出高度。总像素面积必须在 512x512 到 2560x2560 之间；宽高比必须在 1:8 到 8:1 之间。（默认值：1024）	INT	是（当 `size` 为 “custom” 时）	256 到 2560, step 16

文本提示为必填项，且必须至少包含一个字符。
最多支持 3 张参考图像；如果提供更多则会引发错误（批处理输入按每张图像计数一次）。
当 size 设置为 “custom” 时，必须提供明确的宽度和高度值，并进行验证：总像素面积必须介于 262,144（512x512）和 6,553,600（2560x2560）像素之间，且宽高比必须介于 1:8 和 8:1 之间。
当 size 设置为 “match input” 时，至少需要一张参考图像，因为会使用第一张参考图像的尺寸；尺寸会被缩放以适配支持的像素面积和宽高比范围。
当 size 设置为 “auto” 时，模型会选择输出尺寸（1.9-4.2 兆像素），同时保持输入宽高比。
提示引用使用 @Image1、@Image2、@Image3，按输入顺序编号；引用大于已连接图像数量的索引会引发错误。标签仅在单词边界处识别，因此类似 user@image1.com 的地址不会被修改。
输入参考图像在发送到 API 之前会被缩小至最大 2048x2048 像素。如果 PNG 编码超过 API 大小限制，则改用 JPEG 编码。

输出名称	描述	数据类型
`IMAGE`	返回为批次的生成图像。最多返回 `n` 张图像。	IMAGE

本文档由 AI 生成。如果您发现任何错误或有改进建议，欢迎贡献！在 GitHub 上编辑

Source fingerprint (SHA-256): efa8d2b1a039a7b91789c0332b751a5f90ab8dad755ef0e25124d7d1c44d9abb