LumaImageNode - ComfyUI Built-in Node Documentation

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

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

Generates images synchronously based on a text prompt and aspect ratio. This node creates images using text descriptions and allows you to control the image dimensions and style through various reference inputs, including character and style images.

Inputs

Parameter	Data Type	Required	Range	Description
prompt	STRING	Yes	-	Prompt for the image generation (default: empty string). Must be at least 3 characters long.
model	COMBO	Yes	photon-flash-1 photon-1 photon	Model selection for image generation. Different models have different costs.
aspect_ratio	COMBO	Yes	16:9 1:1 4:3 3:2 21:9 9:16 3:4 2:3 9:21	Aspect ratio for the generated image (default: 16:9)
seed	INT	Yes	0 to 18446744073709551615	Seed to determine if node should re-run; actual results are nondeterministic regardless of seed (default: 0)
style_image_weight	FLOAT	No	0.0 to 1.0	Weight of style image. Ignored if no style_image is provided (default: 1.0)
image_luma_ref	LUMA_REF	No	-	Luma Reference node connection to influence generation with input images; up to 4 images can be considered.
style_image	IMAGE	No	-	Style reference image; only 1 image will be used.
character_image	IMAGE	No	-	Character reference images; can be a batch of multiple, up to 4 images can be considered.

Parameter Constraints:

• The prompt must be at least 3 characters long after stripping whitespace.
• The image_luma_ref parameter can accept up to 4 reference images.
• The character_image parameter can accept up to 4 character reference images.
• The style_image parameter accepts only 1 style reference image.
• The style_image_weight parameter is only used when style_image is provided.

Outputs

Output Name	Data Type	Description
output	IMAGE	The generated image based on the input parameters.

---

Source fingerprint (SHA-256): 353d99868c8c09edfab212e49f127585a6cbe1a24d6ee8fe584169adcded2961