# 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.md)

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