Luma Reference - ComfyUI Built-in Node Documentation
Helper node providing reference images for Luma image generation
The Luma Reference node allows you to set reference images and weights to guide the creation process of Luma image generation nodes, making the generated images closer to specific features of the reference images.
Node Function
This node works as a helper tool for Luma generation nodes, allowing users to provide reference images to influence generation results. It enables users to set the weight of reference images to control how much they affect the final result. Multiple Luma Reference nodes can be chained together, with a maximum of 4 working simultaneously according to API requirements.
Parameters
Basic Parameters
Parameter | Type | Default | Description |
---|---|---|---|
image | Image | - | Input image used as reference |
weight | Float | 1.0 | Controls the strength of the reference image’s influence (0-1) |
Output
Output | Type | Description |
---|---|---|
luma_ref | LUMA_REF | Reference object containing image and weight |
Usage Example
Luma Text to Image Workflow Example
Luma Text to Image Workflow Example
How It Works
The Luma Reference node receives image input and allows setting a weight value. The node doesn’t directly generate or modify images but creates a reference object containing image data and weight information, which is then passed to Luma generation nodes.
During the generation process, Luma AI analyzes the features of the reference image and incorporates these features into the generation results based on the set weight. Higher weight values mean the generated image will be closer to the reference image’s features, while lower weight values indicate the reference image will only slightly influence the final result.
Source Code
[Node Source Code (Updated on 2025-05-03)]