Comfy-Org/ComfyUI · error · ValueError

At least one reference image or video is required.

Error message

At least one reference image or video is required.

What it means

Error "At least one reference image or video is required." thrown in Comfy-Org/ComfyUI.

Source

Thrown at comfy_api_nodes/nodes_minimax.py:862

    ) -> IO.NodeOutput:
        validate_string(model["prompt"], strip_whitespace=True, min_length=1)

        reference_images = model.get("reference_images", {})
        reference_videos = model.get("reference_videos", {})
        reference_audios = model.get("reference_audios", {})
        if not reference_images and not reference_videos:
            raise ValueError("At least one reference image or video is required.")

        for image in reference_images.values():
            validate_image_aspect_ratio(image, (2, 5), (5, 2), strict=False)  # 0.4 to 2.5

View on GitHub (pinned to 1c6d8d45b3)

Solutions

1. Connect at least one reference image or video.

When it happens

Trigger: Thrown at comfy_api_nodes/nodes_minimax.py:862 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/832775327f9395c2. Report an issue: GitHub.