Comfy-Org/ComfyUI · error · ValueError

Exactly one reference image is required.

Error message

Exactly one reference image is required.

What it means

Error "Exactly one reference image is required." thrown in Comfy-Org/ComfyUI.

Source

Thrown at comfy_api_nodes/nodes_magnific.py:506

        engine: str,
        portrait_mode: InputPortraitMode,
        fixed_generation: bool,
    ) -> IO.NodeOutput:
        if get_number_of_images(image) != 1:
            raise ValueError("Exactly one input image is required.")
        if get_number_of_images(reference_image) != 1:
            raise ValueError("Exactly one reference image is required.")
        validate_image_aspect_ratio(image, (1, 3), (3, 1), strict=False)
        validate_image_aspect_ratio(reference_image, (1, 3), (3, 1), strict=False)
        validate_image_dimensions(image, min_height=160, min_width=160)

View on GitHub (pinned to 1c6d8d45b3)

Solutions

1. Connect exactly one reference image.

When it happens

Trigger: Thrown at comfy_api_nodes/nodes_magnific.py:506 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of Comfy-Org/ComfyUI@1c6d8d45b3 (2026-08-14). Data as JSON: /api/errors/ec8be40a5604bafe. Report an issue: GitHub.