Ideogram Studio Extras

Ideogram Studio hands you two outputs: the caption string and a fat opaque extras bundle. The extras bundle is where the useful render data hides - overlay image, alpha mask, dimensions, box geometry - but you can't touch any of it directly. Ideogram Studio Extras is the node that breaks it open. Nothing more, nothing less.

It's the most "plumbing" node in this pack, in the good sense: one input, five clean outputs, zero configuration.

What you plug in

The single required input, extras of type IDEOGRAM_EXTRAS, comes from the studio's extras output. That's the only source it accepts. (Fun fact: Ideogram Caption Preview, the sibling node, produces the same bundle type from a raw JSON caption string - so you can feed this node from either one.)

The five outputs

• overlay - an IMAGE of the boxes, labels, text and palette swatches drawn at the studio's chosen resolution. This is what you composite over your generation.
• alpha - a MASK of the overlay, for use as the mask in ImageCompositeMasked. You almost always want overlay + alpha as a pair.
• width / height - the studio's resolution as plain INTs, handy for feeding an Empty Latent or a resize so everything lines up.
• bboxes - the elements as native BOUNDING_BOX data, in the studio's 1-based element order. This is the least obvious output and genuinely useful: wire it into anything that eats a bounding box, or into this pack's Ideogram Studio BBox Select if you only want a few of the boxes for some downstream crop or region node.

The workflow it enables

Wire caption from Ideogram Studio into your Ideogram 4 sampler, and extras into this node. Then take overlay + alpha and composite them over the sampler's output. What you get is a quick visual check - did the model actually place your character where you drew the box, or did it drift? That compare step is the whole reason Ideogram 4's regional prompting is worth the setup, and this node is the bit that makes it visible instead of a leap of faith.

Installing it

Same as the rest of the pack - it ships together:

cd ComfyUI/custom_nodes
git clone https://github.com/nynxz/ComfyUI-IdeogramHelper

Restart ComfyUI, find it under Ideogram → Ideogram Studio Extras. No pip deps, no models to download; it just needs a recent-enough ComfyUI for the V3 node API the pack uses.

Gotchas

If you connect extras and the node outputs nothing, check that it's actually fed from a studio (or Caption Preview) - there's no other way to get an IDEOGRAM_EXTRAS object, and the node silently treats a missing bundle as empty rather than erroring. And remember the overlay only looks right if the studio's resolution matches what the sampler renders; mismatch is the usual reason the boxes sit on top of the wrong pixels.