Ideogram 4 Quad Reference
A reusable cast member — the character, the location, or the prop your prompt keeps talking about
- image
- reference
The prompt half of this pack works like a casting call, and this is your actor. Ideogram4QuadSubject - displayed as "Ideogram 4 Quad Reference" - is a reusable reference entity: a subject (a character), a location (the setting), or an object (a prop). You describe it once, wire it into every frame it appears in, and the Prompt Builder makes sure it's described identically each time. That indirection is the entire trick for keeping one character consistent across four panels.
What it is
A subject has three essential fields:
name- short and stable, like "Mara" or "the diner". This is what gets referenced across panels.description- the long form: appearance, outfit, distinguishing features. Ideogram 4 has famously strong character recall, so a good description goes a long way; be specific about the clothes, the hair, the details that make the character them.type-subject,location, orobject. The type changes how the Prompt Builder phrases recurrences: a character becomes "the EXACT SAME Mara, identical face and outfit", a location becomes "the SAME diner setting", a prop becomes "the SAME briefcase, identical". It matters, because "the same" does different work for a person than for a room.
There's also a color_palette field for hex colors, but here's the neat part: connect an image input and the node auto-extracts the dominant colors for you. It downscales the image to 128px, runs a median-cut quantization with palette_size colors (1–12, default 4), and hands you the top hex values as the palette. Point it at a reference render of your character and their color scheme tags along to every panel automatically.
The output
The single reference output is a QUAD_SUBJECT object bundling type, name, description, and palette. Wire it into the subject_1/subject_2/subject_3 inputs of one or more Ideogram4QuadFrame nodes - up to three per frame, and the same Reference can appear in as many frames as you like. That's the consistency contract: one description, reused everywhere, so it can't drift between panels.
Installing
Same as the whole pack:
cd ComfyUI/custom_nodes
git clone https://github.com/reality-comes/comfyui-ideogram4-quad-storyboard
Restart ComfyUI and it appears under image/ideogram4 (or "Ideogram 4 Quad Storyboard" in ComfyUI Manager). No extra Python dependencies - just ComfyUI's bundled torch and comfy. The color extraction uses numpy and Pillow, which every ComfyUI install already has.
Where people get burned
Two habits to avoid. First, treating description as optional - if it's empty, the only thing the prompt gets is the name, and Ideogram 4 has to invent the rest; that's how "Mara" shows up as a different woman in every panel. Second, relying on the auto-palette as your only consistency tool. Colors help, but the description is what actually carries identity, and if you skip it the "EXACT SAME" language in the prompt has nothing to pin to. Describe once, reuse everywhere, and the hard part of multi-character consistency becomes mostly the model doing its thing.
Inputs (6)
| Name | Type | Default | Description |
|---|---|---|---|
| name | STRING | Subject | — |
| description | STRING | — | |
| color_paletteopt | STRING | — | |
| typeopt | COMBO | subject | 3 options: subject, location, object |
| imageopt | IMAGE | — | |
| palette_sizeopt | INT | 41–12 | — |
Outputs (1)
| Name | Type | Description |
|---|---|---|
| reference | QUAD_SUBJECT | — |