# Ideogram 4.5 精確編輯

使用 Ideogram 4.5 精準編輯，依文字提示編輯影像：只有提示要求的內容會改變，未觸及的像素保持完全相同，且輸出會保持影像 1 的尺寸。影像 1 是要編輯的影像，最多可再連接 4 張影像作為參照。也可以單獨編輯影像 1 的單一區域，透過遮罩或邊界框選取，並傳回完整尺寸的影像。

## 輸入

| 參數 | 描述 | 資料類型 | 必填 | 範圍 |
|-----------|-------------|-----------|----------|-------|
| `模型` | 要使用的模型。（預設值：`"ideogram-4.5"`） | DYNAMIC_COMBO | 是 | `"ideogram-4.5"` |
| `images` | 可增長插槽：影像 1 是要編輯的影像，影像 2 到 5 則是選用參照（`image_1` ... `image_5`）。在提示中以 @Image1、@Image2、... 參照它們；批次輸入會依每張影像各計一次。每張影像的長寬比必須介於 1:6 與 6:1 之間，但使用上下文視窗時，影像 1 不會進行長寬比檢查。 | IMAGE | 是 | 1 至 5 張影像 |
| `prompt` | 編輯指示。支援以 @Image1 形式參照已連接的影像。（預設值：空字串） | STRING | 是 | 1 至 10000 個字元 |
| `quality` | 品質等級。較高等級費用更高且耗時更長。（預設值：`"medium"`） | COMBO | 是 | `"very_low"`<br>`"low"`<br>`"medium"`<br>`"high"` |
| `seed` | 生成用的種子。相同的影像、提示、設定與種子會產生相同結果。（預設值：42） | INT | 是 | 0 至 2147483647 |
| `context_window` | 要編輯的影像 1 區域。`"none"` 會編輯整張影像。`"auto"` 會編輯 `context_window_mask` 周圍的區域，而 `"custom"` 會編輯 `context_window_bboxes` 所指定的區域；兩者都會讓影像 1 保持完整尺寸，且影像其餘部分維持不變。（預設值：`"none"`） | COMBO | 否 | `"none"`<br>`"auto"`<br>`"custom"` |
| `context_window_bboxes` | 要編輯的影像 1 區域，例如 Create Bounding Boxes 的輸出。當 `context_window` 為 `"custom"` 時必填；其他情況不使用。多個邊界框會合併成一個區域，並擴展至每邊至少 256 像素且長寬比為 6:1。此區域每邊最大可達 4608 像素，且約為 4 MP（例如 2048x2048）。 | BOUNDING_BOX | 否 | - |
| `context_window_mask` | 白色標示要編輯的內容；編輯區域會圍繞其放置。當 `context_window` 為 `"auto"` 時必填；其他情況不使用。遮罩必須同時包含白色（編輯）與黑色（保留）區域。 | MASK | 否 | - |

### 參數限制

- **影像數量：** 至少 1 張、最多 5 張影像；批次輸入會依每張影像各計一次。影像 1 是要編輯的影像，影像 2 到 5 則是參照影像。使用 `context_window_mask` 時最多接受 4 張影像，也就是影像 1 加上 3 張參照影像。
- **輸出尺寸：** 結果會保持影像 1 的尺寸，因此此節點沒有尺寸、寬度或高度輸入。編輯區域時也是如此，會傳回完整影像，且僅有該區域被變更。
- **影像長寬比：** 每張影像的寬度不得超過其高度的 6 倍，且高度不得超過其寬度的 6 倍（介於 1:6 與 6:1 之間）。當 `context_window` 為 `"auto"` 或 `"custom"` 時，影像 1 不受此限，因為只會傳送其選定區域。
- **區域來源尺寸：** 使用上下文視窗時，影像 1 最大可達 8192x8192 像素（約 67 MP）；更大的來源會引發錯誤。未使用上下文視窗時，若影像大於約 4 MP 或長邊超過 4608 px，會在傳送前先縮小。
- **區域限制：** 來自 `context_window_bboxes` 的區域每邊最大可達 4608 像素且約 4 MP；完全落在影像 1 之外的邊界框會引發錯誤。
- **提示標籤：** `@ImageN` 會以不區分大小寫的方式比對，且不得超過已連接影像的數量；提示必須非空白且最多 10000 個字元。
- **上傳限制：** 影像 1、遮罩與參照影像合計必須符合 Ideogram 的 50 MB 上傳限制；必要時會將影像 1 重新編碼為 JPEG，若仍無法符合限制，節點會引發錯誤。
- **內容安全：** 若 Ideogram 的內容安全篩選器封鎖結果，節點會引發錯誤，而不是傳回影像。

## 輸出

| 輸出名稱 | 描述 | 資料類型 |
|-------------|-------------|-----------|
| `IMAGE` | 編輯後的影像，以批次形式輸出，尺寸與影像 1 相同。 | IMAGE |

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

---
**Source fingerprint (SHA-256):** `84f042739a8d7bc1a4b268f6175be6a598b67d32b9311fdf204a923472f5fcc9`
