> ## Documentation Index
> Fetch the complete documentation index at: https://docs.comfy.org/llms.txt
> Use this file to discover all available pages before exploring further.

# IdeogramPreciseEditApi - ComfyUI Built-in Node Documentation

> 使用 Ideogram 4.5 精准编辑功能，通过文本提示词引导编辑图像：只有提示词要求的内容会发生变化，未涉及的像素保持完全一致，且输出保持 image 1 的尺寸。

使用 Ideogram 4.5 精准编辑功能，通过文本提示词引导编辑图像：只有提示词要求的内容会发生变化，未涉及的像素保持完全一致，且输出保持 image 1 的尺寸。image 1 是要编辑的图像，最多还可连接 4 张图像作为参考。

## 输入

| Parameter | Description | Data Type | Required | Range |
| - | - | - | - | - |
| `模型` | 要使用的模型。（默认值：`"ideogram-4.5"`） | DYNAMIC\_COMBO | 是 | `"ideogram-4.5"` |
| `images` | 可扩展插槽：image 1 是要编辑的图像，images 2 到 5 是可选参考图（`image_1` ... `image_5`）。在提示词中用 @Image1、@Image2……来引用它们；批量输入按每张图像各计一次。每张图像的宽高比必须在 1:6 到 6: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 |

### 参数约束

* **图像数量：** 至少 1 张、最多 5 张图像；批量输入按每张图像各计一次。Image 1 是要编辑的图像，images 2 到 5 是参考图。
* **输出尺寸：** 结果保持 image 1 的尺寸，因此此节点没有尺寸、宽度或高度输入。
* **图像宽高比：** 每张图像的宽度不得超过其高度的 6 倍，高度也不得超过其宽度的 6 倍（介于 1:6 到 6:1 之间）。
* **提示词标签：** `@ImageN` 的匹配不区分大小写，且其编号不得超过已连接图像的数量；提示词不能为纯空白字符，且最多 10000 个字符。
* **上传缩放：** 大于约 4 MP，或长边超过 4608 px 的图像，在发送前会被缩小。
* **内容安全：** 如果 Ideogram 的内容安全过滤器拦截了结果，节点会抛出错误，而不是返回图像。

## 输出

| Output Name | Description | Data Type |
| - | - | - |
| `IMAGE` | 编辑后的图像，以批次形式输出，尺寸与 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):** `74ba429ac93e4528e44c864ccfd3928f6c42108cfcc83577c8963a099a66f527`


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.