IdeogramV3 - ComfyUI Built-in Node Documentation

This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! Edit on GitHub

The Ideogram V3 node generates images using the Ideogram V3 model. It supports both regular image generation from text prompts and image editing when both an image and mask are provided. The node offers various controls for aspect ratio, resolution, generation speed, and optional character reference images.

Inputs

Parameter	Data Type	Required	Range	Description
`prompt`	STRING	Yes	-	Prompt for the image generation or editing (default: empty)
`image`	IMAGE	No	-	Optional reference image for image editing
`mask`	MASK	No	-	Optional mask for inpainting (white areas will be replaced)
`aspect_ratio`	COMBO	No	”1:1" "16:9" "9:16" "4:3" "3:4" "3:2" "2:3”	The aspect ratio for image generation. Ignored if resolution is not set to Auto (default: “1:1”)
`resolution`	COMBO	No	”Auto" "1024x1024" "1152x896" "896x1152" "1216x832" "832x1216" "1344x768" "768x1344" "1536x640" "640x1536”	The resolution for image generation. If not set to Auto, this overrides the aspect_ratio setting (default: “Auto”)
`magic_prompt_option`	COMBO	No	”AUTO" "ON" "OFF”	Determine if MagicPrompt should be used in generation (default: “AUTO”)
`seed`	INT	No	0-2147483647	Random seed for generation (default: 0)
`num_images`	INT	No	1-8	Number of images to generate (default: 1)
`rendering_speed`	COMBO	No	”DEFAULT" "TURBO" "QUALITY”	Controls the trade-off between generation speed and quality (default: “DEFAULT”)
`character_image`	IMAGE	No	-	Image to use as character reference
`character_mask`	MASK	No	-	Optional mask for character reference image

Parameter Constraints:

When both image and mask are provided, the node switches to editing mode
If only one of image or mask is provided, an error will occur
character_mask requires character_image to be present
The aspect_ratio parameter is ignored when resolution is not set to “Auto”
White areas in the mask will be replaced during inpainting
Character mask and character image must be the same size

Outputs

Output Name	Data Type	Description
`output`	IMAGE	The generated or edited image(s)

​Inputs

​Outputs

Inputs

Outputs