文档 /
节点说明 /
Ideogram 4.5 精确编辑
Ideogram 4.5 精确编辑
编辑图像，由文本提示指引，使用 Ideogram 4.5 精确编辑：只改变提示要求的内容，未触及的像素保持完全一致，输出保持图像 1 的尺寸。
节点说明
IdeogramPreciseEditApi 更新于 2026-11-12
Ideogram 4.5 精确编辑 - ComfyUI Built-in Node Documentation
编辑图像，由文本提示指引，使用 Ideogram 4.5 精确编辑：只改变提示要求的内容，未触及的像素保持完全一致，输出保持图像 1 的尺寸。
编辑图像，由文本提示指引，使用 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" "low" "medium" "high" |
seed | 生成用的种子。相同的图像、提示词、设置和种子会得到相同的结果。（默认值：42） | INT | 是 | 0 到 2147483647 |
context_window | 图像 1 中要编辑的区域。"none" 编辑整张图像。"auto" 编辑 context_window_mask 周围的区域，"custom" 编辑 context_window_bboxes 指定的区域；两者都保持图像 1 为原始尺寸，并让图像的其余部分保持不变。（默认值："none"） | COMBO | 否 | "none" "auto" "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 上编辑
Source fingerprint (SHA-256): 84f042739a8d7bc1a4b268f6175be6a598b67d32b9311fdf204a923472f5fcc9