Comfy-Org/ComfyUI · error · ValueError

Maximum number of images per subject is 3.

Error message

Maximum number of images per subject is 3.

What it means

Error "Maximum number of images per subject is 3." thrown in Comfy-Org/ComfyUI.

Source

Thrown at comfy_api_nodes/nodes_vidu.py:809

        resolution: str,
        movement_amplitude: str,
    ) -> IO.NodeOutput:
        validate_string(prompt, min_length=1, max_length=2000)
        total_images = 0
        for i in subjects:
            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))

View on GitHub (pinned to 1c6d8d45b3)

Solutions

1. Use at most 3 images per subject.

When it happens

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