> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-docs-partner-nodes-consolidate.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# QwenImageEditApi - ComfyUI Built-in Node Documentation

> 此节点使用 Qwen-Image 3.0 模型，在文本提示的引导下编辑或组合最多 3 张参考图像。

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

## 输入

### 通用输入

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

### qwen-image-3.0-pro 和 qwen-image-3.0 输入

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

| 参数                | 描述                                         | 数据类型   | 必需 | 范围 |
| ----------------- | ------------------------------------------ | ------ | -- | -- |
| `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](mailto:user@image1.com) 的地址不会被修改。
* 输入参考图像在发送到 API 之前会被缩小至最大 2048x2048 像素。如果 PNG 编码超过 API 大小限制，则改用 JPEG 编码。

## 输出

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

> 本文档由 AI 生成。如果您发现任何错误或有改进建议，欢迎贡献！ [在 GitHub 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/QwenImageEditApi/zh.md)

***

**Source fingerprint (SHA-256):** `efa8d2b1a039a7b91789c0332b751a5f90ab8dad755ef0e25124d7d1c44d9abb`
