Ideogram 4 Quad Storyboard

ComfyUI Ideogram 4 Quad Storyboard

Nodes for building, masking, and sampling 2×2 "quad" keyframe canvases with Ideogram 4 in ComfyUI. Composite reference images into the four panels of a quad layout, lock or partially regenerate each panel independently, inpaint within a panel, and release a panel to free generation after a set number of steps.

Nodes

Ideogram 4 Quad Keyframe — Ideogram4QuadKeyframe

Position-centric quad keyframe builder.

• Connect up to 4 reference images (image_1…image_4) and 4 masks (mask_1…mask_4, paired with the images).
• For each panel (top-left / top-right / bottom-left / bottom-right) choose:
  • <panel>_image — which loaded image to place there (or none). The same image can be reused in multiple panels.
  • <panel>_denoise — 0 = frozen keyframe, >0 = soft seed / partial regeneration.
  • <panel>_mask_mode — ignore (uniform), denoise_masked (regenerate only the painted region — classic inpaint), or denoise_unmasked (the inverse).
• Outputs canvas (→ VAEEncode) and noise_mask (→ SetLatentNoiseMask).
• mask_feather softens mask edges to avoid seams; lock_gutters freezes the gutter/margin areas.

Ideogram 4 Quad Keyframe Release — Ideogram4QuadKeyframeRelease

A model patch (insert in the MODEL chain before the guider) that overrides the per-step denoise mask so a panel's reference is only injected for the first N steps, then that panel generates freely.

• <panel>_lock_steps — -1 = locked the whole run (default, no-op), 0 = never injected, N = injected for the first N steps then released.
• release_mode — hard (instant) or gradual (fades over fade_steps).
• <panel>_respect_mask — when on, only the editable part of an inpaint-masked panel releases; mask-protected pixels stay locked to the reference for the whole run.

Geometry widgets must match the keyframe node so the panel rectangles line up.

Ideogram 4 Quad Split — Ideogram4QuadSplit

Crops the four finished panels back out of the rendered canvas (matching the keyframe node's margin/gutter geometry), returning each panel plus a 4-image batch.

Ideogram 4 Quad Layout — Ideogram4QuadLayout

Single source of truth for the quad geometry. Set width / height / frame size / gutter / margin once; outputs a QUAD_LAYOUT (with per-cell bounding boxes) plus the raw geometry ints to drive the Keyframe, Split, Scheduler, and Prompt Builder.

Ideogram 4 Quad Reference — Ideogram4QuadSubject

A reusable reference entity — a subject (character), location (setting), or object (prop). Define once and wire it into every frame it appears in; connect an image to auto-extract its dominant colors as a palette.

Ideogram 4 Quad Frame — Ideogram4QuadFrame

One storyboard frame: a target panel, an action/shot description, and the cast (up to 3 Reference nodes wired in).

Ideogram 4 Quad Prompt Builder — Ideogram4QuadPromptBuilder

Assembles the Ideogram 4 quad JSON prompt from a layout + up to four frames. Consistency is enforced per subject: a character is established on first appearance and stamped "the EXACT SAME …" on every later panel, so multiple subjects can recur in different combinations and each stays locked.

Installation

Clone into your ComfyUI custom_nodes directory:

cd ComfyUI/custom_nodes
git clone https://github.com/reality-comes/comfyui-ideogram4-quad-storyboard

Then restart ComfyUI. The nodes appear under the image/ideogram4 category.

No extra Python dependencies — uses ComfyUI's bundled torch and comfy.

License

MIT — see LICENSE.