{"record":{"id":"ec8be40a5604bafe","repo":"Comfy-Org/ComfyUI","slug":"exactly-one-reference-image-is-required","errorCode":null,"errorMessage":"Exactly one reference image is required.","messagePattern":"Exactly one reference image is required\\.","errorType":"validation","errorClass":"ValueError","httpStatus":null,"severity":"error","filePath":"comfy_api_nodes/nodes_magnific.py","lineNumber":506,"sourceCode":"        engine: str,\n        portrait_mode: InputPortraitMode,\n        fixed_generation: bool,\n    ) -> IO.NodeOutput:\n        if get_number_of_images(image) != 1:\n            raise ValueError(\"Exactly one input image is required.\")\n        if get_number_of_images(reference_image) != 1:\n            raise ValueError(\"Exactly one reference image is required.\")\n        validate_image_aspect_ratio(image, (1, 3), (3, 1), strict=False)\n        validate_image_aspect_ratio(reference_image, (1, 3), (3, 1), strict=False)\n        validate_image_dimensions(image, min_height=160, min_width=160)","sourceCodeStart":488,"sourceCodeEnd":524,"githubUrl":"https://github.com/Comfy-Org/ComfyUI/blob/1c6d8d45b3693bfbb32385b410d813a7fd6be216/comfy_api_nodes/nodes_magnific.py#L488-L524","documentation":"Error \"Exactly one reference image is required.\" thrown in Comfy-Org/ComfyUI.","triggerScenarios":"Thrown at comfy_api_nodes/nodes_magnific.py:506 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Connect exactly one reference image."],"exampleFix":null,"handlingStrategy":null,"validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"1c6d8d45b3693bfbb32385b410d813a7fd6be216","analyzedAt":"2026-08-14T19:37:18.893Z","schemaVersion":2},"datasetVersion":"2026-08-15T22:17:37.221Z"}