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" "16:9" "9:16" "4:3" "3:4" "3:2" "2:3”
分辨率	图像生成的分辨率。如果未设置为”自动”，则此参数会覆盖宽高比设置（默认值：“Auto”）	COMBO	否	”Auto" "1024x1024" "1152x896" "896x1152" "1216x832" "832x1216" "1344x768" "768x1344" "1536x640" "640x1536”
Magic Prompt	确定生成时是否使用 MagicPrompt（默认值：“AUTO”）	COMBO	否	”AUTO" "ON" "OFF”
随机种	生成用的随机种子（默认值：0）	INT	否	0-2147483647
图像数量	生成的图像数量（默认值：1）	INT	否	1-8
生成速度	控制生成速度与质量之间的权衡（默认值：“DEFAULT”）	COMBO	否	”DEFAULT" "TURBO" "QUALITY”
角色图像	用作人物参考的图像	IMAGE	否	-
角色遮罩	人物参考图像的可选遮罩	MASK	否	-

参数约束：

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

​

输出

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

本文档由 AI 生成。如果您发现任何错误或有改进建议，欢迎贡献！ 在 GitHub 上编辑

---

Source fingerprint (SHA-256): 0d0058cc8483c453100d8d9dfcb9a31ae5e686f38ced77ed7e472cd083c3464b