# Tencent HY Image: Edit

Tencent HY Image: Edit 節點會使用騰訊的 Hunyuan Image 模型，根據文字指令編輯或合併參考影像。連接一至五張影像，在 `prompt` 中描述變更，並以 `@Image1`、`@Image2` 等方式參照這些影像。此節點會上傳參考影像、將請求傳送至 API，並回傳編輯後的結果。

## 輸入

### 通用輸入

| 參數 | 說明 | 資料類型 | 必要 | 範圍 |
|-----------|-------------|-----------|----------|-------|
| `模型` | 用於編輯的模型。所選模型會決定顯示哪些額外輸入。 | DYNAMIC_COMBO | 是 | `"hy-image-3.5-preview"` |

### hy-image-3.5-preview 輸入

| 參數 | 說明 | 資料類型 | 必要 | 範圍 |
|-----------|-------------|-----------|----------|-------|
| `prompt` | 編輯指令。支援以 `@Image1` 形式參照已連接的影像。不得為空（預設：空）。 | STRING | 是 | 任意文字 |
| `aspect_ratio` | 輸出的長寬比。`"auto"` 會沿用第一張參考影像的長寬比，且在 4K 時無法使用。當 `resolution` 為 `"custom"` 時會被忽略。 | COMBO | 是 | `"auto"`<br>`"1:1"`<br>`"3:2"`<br>`"2:3"`<br>`"4:3"`<br>`"3:4"`<br>`"16:9"`<br>`"9:16"`<br>`"21:9"`<br>`"9:21"`（預設：`"auto"`） |
| `resolution` | 輸出的像素面積：1K 約為 1024x1024，2K 約為 2048x2048，4K 約為 4096x4096。高於 2K 的設定會以 2K 渲染，並由模型放大。設為 `"custom"` 以使用 `width` 和 `height`，而非預設面積。 | COMBO | 是 | `"1K"`<br>`"2K"`<br>`"4K"`<br>`"custom"`（預設：`"2K"`） |
| `width` | 輸出的像素寬度。僅當 `resolution` 為 `"custom"` 時使用。 | INT | 是 | 256-8192，步長 16（預設：2048） |
| `height` | 輸出的像素高度。僅當 `resolution` 為 `"custom"` 時使用。 | INT | 是 | 256-8192，步長 16（預設：2048） |
| `seed` | 用於生成的種子。即使使用相同種子，每次執行的結果仍會有所不同。 | INT | 是 | 0-2147483647（預設：42） |
| `reference_detail` | 模型能看到參考影像的細節程度：`"standard"` 允許每張影像最多 1024x1024 像素，`"high"` 最多 2048x2048，能更好地保留小字與精細細節，但耗時較長。這是進階參數。 | COMBO | 否 | `"standard"`<br>`"high"`（預設：`"standard"`） |
| `watermark` | 是否在結果中加入 AI 生成浮水印。這是進階參數。 | BOOLEAN | 否 | true<br>false（預設：false） |

### 參考輸入

| 參數 | 說明 | 資料類型 | 必要 | 範圍 |
|-----------|-------------|-----------|----------|-------|
| `images` | 要編輯或合併的參考影像。可擴充插槽：連接 1 至 5 張影像（`image_1` 至 `image_5`）。在 `prompt` 中以 `@Image1` ... `@Image5` 參照它們，編號依輸入順序而定；批次輸入中的每張影像各計為一次。 | IMAGE | 是 | 1-5 張影像 |

`prompt` 不得為空；當僅連接 1 或 2 張影像時，若 `prompt` 中包含 `@Image3` 這類參照，將會引發錯誤。總共最多可使用 5 張參考影像，批次中的每張影像會分別計數。當 `resolution` 為 `"custom"` 時，`width` 和 `height` 都必須是 16 的倍數，且兩者的乘積不得超過 4096 x 4096 像素的面積限制（約 1,670 萬像素）；任何長寬比皆可使用，但超過約 6:1 後，模型會開始重複主體。`"auto"` 長寬比僅能在 2K 面積限制內運作，因此在 4K 時請選擇明確的長寬比，或使用 `"custom"`。

## 輸出

| 輸出名稱 | 說明 | 資料類型 |
|-------------|-------------|-----------|
| `IMAGE` | 依據參考影像與 `prompt` 產生的編輯後影像。 | IMAGE |

> 本文檔由 AI 生成。如果您發現任何錯誤或有改進建議，歡迎貢獻！ [在 GitHub 上編輯](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/HunyuanImageEditApi/zh-TW.md)

---
**Source fingerprint (SHA-256):** `46c112347b51a2983521f87bbeb047289515f4073c48ba5d909fd3bae4597633`
