Comfy-Org/ComfyUI · error · ValueError

Too many reference images; the maximum allowed is 7.

Error message

Too many reference images; the maximum allowed is 7.

What it means

Error "Too many reference images; the maximum allowed is 7." thrown in Comfy-Org/ComfyUI.

Source

Thrown at comfy_api_nodes/nodes_vidu.py:815

            if get_number_of_images(subjects[i]) > 3:
                raise ValueError("Maximum number of images per subject is 3.")
            for im in subjects[i]:
                total_images += 1
                validate_image_aspect_ratio(im, (1, 4), (4, 1))
                validate_image_dimensions(im, min_width=128, min_height=128)
        if total_images > 7:
            raise ValueError("Too many reference images; the maximum allowed is 7.")
        subjects_param: list[SubjectReference] = []
        for i in subjects:
            subjects_param.append(

View on GitHub (pinned to 1c6d8d45b3)

Solutions

1. Use at most 7 reference images.

When it happens

Trigger: Thrown at comfy_api_nodes/nodes_vidu.py:815 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/b09dadfa95f2a291. Report an issue: GitHub.