{"record":{"id":"0f7bbbfd90a1e0b0","repo":"Comfy-Org/ComfyUI","slug":"character-mask-requires-character-image-to-be-pres","errorCode":null,"errorMessage":"Character mask requires character image to be present","messagePattern":"Character mask requires character image to be present","errorType":"validation","errorClass":"Exception","httpStatus":null,"severity":"error","filePath":"comfy_api_nodes/nodes_ideogram.py","lineNumber":296,"sourceCode":"            img = Image.fromarray(img_np)\n            img_byte_arr = BytesIO()\n            img.save(img_byte_arr, format=\"PNG\")\n            img_byte_arr.seek(0)\n            character_img_binary = img_byte_arr\n            character_img_binary.name = \"image.png\"\n        elif character_mask is not None:\n            raise Exception(\"Character mask requires character image to be present\")\n\n        # Check if both image and mask are provided for editing mode\n        if image is not None and mask is not None:","sourceCodeStart":278,"sourceCodeEnd":314,"githubUrl":"https://github.com/Comfy-Org/ComfyUI/blob/1c6d8d45b3693bfbb32385b410d813a7fd6be216/comfy_api_nodes/nodes_ideogram.py#L278-L314","documentation":"Error \"Character mask requires character image to be present\" thrown in Comfy-Org/ComfyUI.","triggerScenarios":"Thrown at comfy_api_nodes/nodes_ideogram.py:296 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Connect a character image when providing a character mask."],"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-15T17:31:12.345Z"}