Reference Node
Treat references as inspectable image sources, not as a catch-all for every media type.
Where Reference images come from
Upload Image, a dropped image, or an extracted video frame can produce a Reference node. The node displays an image and can feed image-compatible downstream ports.
- Right-click blank canvas, choose Upload → Upload Image, pick a product photo, wait for archive, and left-click to place the ghost.
- Inspect the Reference preview before wiring it; a wrong source is cheaper to replace before generation.
Feed an image-generation reference
The Reference card has an image output on its right. Image Generation exposes a Reference image input and an @ picker for connected images with usable URLs.
- Drag Reference output to Image’s Reference image port and select the Image node.
- Choose the matching thumbnail under @ reference media, then prompt for a new setting while naming details to preserve.
Carry a frame into video
An image Reference may supply a first frame or other visual reference only if the selected Video model supports that kind of input. Some video presets instead expect a source video or audio.
- Select Video’s model, read its input port labels, then connect the Reference to an allowed image handle.
- If the @ picker appears, choose the frame and describe movement after that still, for example a slow dolly around the subject.
Do not confuse Reference with upload media
Upload Video creates a Video node and Upload Audio creates an Audio node. A Reference image is not a container that converts video/audio into an acceptable image input.
- For a still from a video, use Video → Extract Frames and connect the completed video to its Video input.
- Use the new Reference node created by extraction as the picture for a later Image or supported Video node.
When a reference is blank or ignored
A blank Reference preview indicates there is no usable image yet. Even a visible picture will not reach a model if its connection, selection, or model input rules are wrong.
- Open the source preview, then confirm the edge reaches the correct image input and its thumbnail is selected where applicable.
- If you only have a video or audio source, keep its real media type and choose a compatible port; extract a frame first if you specifically need a still.
Visual resemblance is model-dependent; references guide generation but do not lock an object or identity perfectly.