Comfy-Org/ComfyUI · error · Exception

Character mask requires character image to be present

Error message

Character mask requires character image to be present

What it means

Error "Character mask requires character image to be present" thrown in Comfy-Org/ComfyUI.

Source

Thrown at comfy_api_nodes/nodes_ideogram.py:296

            img = Image.fromarray(img_np)
            img_byte_arr = BytesIO()
            img.save(img_byte_arr, format="PNG")
            img_byte_arr.seek(0)
            character_img_binary = img_byte_arr
            character_img_binary.name = "image.png"
        elif character_mask is not None:
            raise Exception("Character mask requires character image to be present")

        # Check if both image and mask are provided for editing mode
        if image is not None and mask is not None:

View on GitHub (pinned to 1c6d8d45b3)

Solutions

1. Connect a character image when providing a character mask.

When it happens

Trigger: Thrown at comfy_api_nodes/nodes_ideogram.py:296 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/0f7bbbfd90a1e0b0. Report an issue: GitHub.