> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-comfy-docs-comfyapi-search.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"
"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 |
### 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 之间；该面积内的任意宽高比都可以。（默认值：1024） | INT | 是（当 `size` 为 "custom" 时） | 256 到 2560, step 16 |
| `height` | 输出高度。总像素面积必须介于 512x512 和 2560x2560 之间；该面积内的任意宽高比都可以。（默认值：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`