Comfy-Org/ComfyUI · error · ValueError

Maximum 4 reference images are allowed.

Error message

Maximum 4 reference images are allowed.

What it means

Error "Maximum 4 reference images are allowed." thrown in Comfy-Org/ComfyUI.

Source

Thrown at comfy_api_nodes/nodes_quiver.py:149

        references = None
        if reference_images:
            references = []
            for key in reference_images:
                url = await upload_image_to_comfyapi(cls, reference_images[key], mime_type="image/png")
                references.append(QuiverImageObject(url=url))
            if len(references) > 4:
                raise ValueError("Maximum 4 reference images are allowed.")

        instructions_val = instructions.strip() if instructions else None
        if instructions_val == "":

View on GitHub (pinned to 1c6d8d45b3)

Solutions

1. Use at most 4 reference images.

When it happens

Trigger: Thrown at comfy_api_nodes/nodes_quiver.py:149 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/a120aca6711b957e. Report an issue: GitHub.