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

# IdeogramV3 - ComfyUI Built-in Node Documentation

> Complete documentation for the IdeogramV3 node in ComfyUI. Learn its inputs, outputs, parameters and usage.

此节点使用 Ideogram V3 模型生成图像。它支持从文本提示进行常规图像生成，以及在同时提供图像和遮罩时进行图像编辑。该节点提供多种控制选项，包括宽高比、分辨率、生成速度以及可选的参考人物图像。

## 输入

| 参数             | 描述                                           | 数据类型   | 是否必需 | 取值范围                                                                                                                                                    |
| -------------- | -------------------------------------------- | ------ | ---- | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `提示词`          | 图像生成或编辑的提示词（默认值：空）                           | STRING | 是    | -                                                                                                                                                       |
| `图像`           | 用于图像编辑的可选参考图像                                | IMAGE  | 否    | -                                                                                                                                                       |
| `遮罩`           | 用于修复的可选遮罩（白色区域将被替换）                          | MASK   | 否    | -                                                                                                                                                       |
| `宽高比`          | 图像生成的宽高比。如果分辨率未设置为"自动"，则忽略此参数（默认值："1:1"）     | COMBO  | 否    | "1:1"<br />"16:9"<br />"9:16"<br />"4:3"<br />"3:4"<br />"3:2"<br />"2:3"                                                                               |
| `分辨率`          | 图像生成的分辨率。如果未设置为"自动"，则此参数会覆盖宽高比设置（默认值："Auto"） | COMBO  | 否    | "Auto"<br />"1024x1024"<br />"1152x896"<br />"896x1152"<br />"1216x832"<br />"832x1216"<br />"1344x768"<br />"768x1344"<br />"1536x640"<br />"640x1536" |
| `Magic Prompt` | 确定生成时是否使用 MagicPrompt（默认值："AUTO"）            | COMBO  | 否    | "AUTO"<br />"ON"<br />"OFF"                                                                                                                             |
| `随机种`          | 生成用的随机种子（默认值：0）                              | INT    | 否    | 0-2147483647                                                                                                                                            |
| `图像数量`         | 生成的图像数量（默认值：1）                               | INT    | 否    | 1-8                                                                                                                                                     |
| `生成速度`         | 控制生成速度与质量之间的权衡（默认值："DEFAULT"）                | COMBO  | 否    | "DEFAULT"<br />"TURBO"<br />"QUALITY"                                                                                                                   |
| `角色图像`         | 用作人物参考的图像                                    | IMAGE  | 否    | -                                                                                                                                                       |
| `角色遮罩`         | 人物参考图像的可选遮罩                                  | MASK   | 否    | -                                                                                                                                                       |

**参数约束：**

* 当同时提供 `image` 和 `mask` 时，节点切换到编辑模式
* 如果仅提供 `image` 或 `mask` 中的一项，将会报错
* `character_mask` 需要同时提供 `character_image`
* 当 `resolution` 未设置为"Auto"时，`aspect_ratio` 参数将被忽略
* 遮罩中的白色区域将在修复过程中被替换
* 人物遮罩和人物图像必须具有相同尺寸

## 输出

| 输出名称     | 描述        | 数据类型  |
| -------- | --------- | ----- |
| `output` | 生成或编辑后的图像 | IMAGE |

> 本文档由 AI 生成。如果您发现任何错误或有改进建议，欢迎贡献！ [在 GitHub 上编辑](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/IdeogramV3/zh.md)

***

**Source fingerprint (SHA-256):** `0d0058cc8483c453100d8d9dfcb9a31ae5e686f38ced77ed7e472cd083c3464b`