# Qwen Image 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 之間；該範圍內任何長寬比皆可。（預設值：1024） | INT | 是（當 `size` 為 "custom" 時） | 256 至 2560 （步進值：16） |
| `height` | 輸出高度。總像素面積必須介於 512x512 與 2560x2560 之間；該範圍內任何長寬比皆可。（預設值：1024） | INT | 是（當 `size` 為 "custom" 時） | 256 至 2560 （步進值：16） |

### 限制條件

- 文字提示詞為必填，且必須至少包含一個字元。
- 最多支援 3 張參考圖像；若提供更多則會引發錯誤（批次輸入會以每張圖像各計一次）。
- 當 `size` 設為 "custom" 時，必須提供明確的 `width` 與 `height` 值，且會進行驗證：總像素面積必須介於 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 上編輯](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/QwenImageEditApi/zh-TW.md)

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