<h1 id="ideogram-v4-visual-guidanceprompting-with-reference-images">Ideogram V4 Visual Guidance/Prompting with Reference Images</h1><h2 id="why-this-workflow">Why this workflow?</h2>Ideogram V4 is an excellent text-to-image model. But what happens if we also feed it visual information from one or two reference images?This workflow adds experimental visual guidance to Ideogram V4 by reusing the Qwen3-VL-based visual-conditioning path of the enhanced Krea2 text encoder by ethanfel. The result is often surprisingly strong: composition, appearance, objects, colours, and even quite detailed structural information can survive the visual-language pathway and meaningfully influence a completely new generation.The goal is not pixel-perfect image editing. Instead, the reference images act as visual prompts that are combined with normal text prompting.<h2 id="core-idea">Core idea</h2>The workflow uses two conditioning branches:<ul><li>Text-only conditioning</li><li>Visual guidance conditioning, containing the same text prompt plus visual tokens extracted from the reference image(s)</li></ul>Sampling is split into two stages:<ul><li>At higher sigmas, only the text-only branch is used</li><li>At lower sigmas, the visual guidance branch is added</li></ul>This helps Ideogram V4 first establish the coarse scene structure from the text prompt and only afterwards incorporate the visual guidance.A second control, Visual Guidance Branch Weight, determines how strongly the visual guidance branch contributes once it becomes active.<h2 id="workflow-handling">Workflow handling</h2>Up to two reference images can be used.Each reference image can be:<ul><li>used directly,</li><li>masked,</li><li>cropped to the masked region,</li><li>or have irrelevant regions blanked or blurred before visual encoding.</li></ul>This is useful when only one person, object, clothing item, landscape feature, etc. should influence the result.A reference image can be disabled completely by disconnecting its link between:<ul><li>Ref. Image Interface and Text Encode (Krea2)</li></ul>Automatic person masking is included only as an optional convenience feature. The corresponding nodes can simply be deleted if the package is not installed.Most operating details are already documented directly inside the workflow via note boxes, including:<ul><li>reference image handling,</li><li>masking options,</li><li>sigma split,</li><li>visual guidance branch weight,</li><li>and recommended starting settings.</li></ul>The workflow can also be run with an empty or nearly empty text prompt. This can be useful for pure image reinterpretation or image fusion, although the result is naturally less controllable.<h2 id="three-key-visual-guidance-parameters">Three key visual-guidance parameters</h2>Visual guidance is mainly controlled by three parameters. They affect different aspects of the process and should not be regarded as interchangeable “strength” controls.<h3 id="1.-sigma-threshold">1. Sigma Threshold</h3>Controls when visual guidance starts.<ul><li>Higher values mean visual guidance enters earlier</li><li>Lower values give the text-only branch more time to stabilise the coarse scene first</li></ul>So this parameter mainly affects the stability of the base scene defined by the text prompt.<h3 id="2.-visual-guidance-branch-weight">2. Visual Guidance Branch Weight</h3>Controls how strongly the visual-guidance branch influences the result once it is active.Important: this branch contains text + visual tokens, not visual information alone.Rough interpretation:<ul><li><code>0.0</code> -&gt; text only</li><li><code>&gt;= 1.0</code> -&gt; predominantly guided by the reference image(s)</li></ul>So this parameter mainly affects the overall influence strength of the visual tokens relative to the text-only branch.<h3 id="3.-vision_megapixels">3. vision_megapixels</h3>Controls the image resolution used inside Text Encode (Krea2) for visual encoding.Higher values generally preserve more structural and fine-grained visual information. In practice, this affects the detail level contained in the visual tokens.<h3 id="rule-of-thumb">Rule of thumb</h3>These three controls interact. A useful rule of thumb is: The higher <code>vision_megapixels</code>, the lower the Visual Guidance Branch Weight will usually need to be to maintain a good balance with the text prompt.In short:<ul><li>Sigma Threshold = when visual guidance starts</li><li>Visual Guidance Branch Weight = how strongly it acts</li><li><code>vision_megapixels</code>= how much visual detail it can provide</li></ul><h3 id="recommended-starting-points">Recommended starting points</h3>Useful starting values are often around:<ul><li>Sigma Threshold: <code>0.92 ... 0.96</code></li><li>Visual Guidance Branch Weight: <code>0.65 ... 0.85</code></li></ul>However, these are only starting points, not strict operating limits.Depending on:<ul><li>the reference images,</li><li>the requested scene,</li><li>the amount of visual detail,</li><li>and Ideogram V4’s own model biases,</li></ul>much more extreme settings can still be useful.Examples:<ul><li>Sigma Threshold = 1.0 may work better when Ideogram otherwise commits too early to an unwanted default scene structure</li><li>Visual Guidance Branch Weight &gt; 1.0 can sometimes be useful if important reference information is otherwise too weak</li></ul>A concrete example is a riverside scene: Ideogram had a strong bias toward showing only a narrow strip of the opposite riverbank. In that case, only Sigma Threshold = 1.0 worked well, because visual guidance had to be active from the very beginning in order to steer the global composition.So the practical message is: Use the recommended values as a starting point, but do not hesitate to test substantially stronger settings when the model’s own priors dominate too much. Also note that the parameter effects are not always linear. Even small changes can sometimes lead to noticeably different interpretations.<h2 id="use-cases">Use cases</h2>The workflow supports several interesting usage modes. The example panels on the page illustrate the three most important ones.<h3 id="1.-guided-scene-generation">1. Guided scene generation</h3>Use two reference images plus a text prompt.Typical pattern:<ul><li>one image provides a person, object, or appearance cue,</li><li>the other provides environment, atmosphere, or scene context,</li><li>the text prompt defines the actual event or scenario.</li></ul>This is illustrated by the panel with the firefighter / woman / mountain fire scene and also by the dog / harbour riverside example.<h3 id="2.-image-reinterpretation">2. Image reinterpretation</h3>Use one reference image plus a text prompt that specifies the output domain or style.Examples:<ul><li><code>"Real photograph."</code></li><li><code>"Impressionist painting."</code></li></ul>This allows a single reference image to be reinterpreted into different output styles or domains while preserving substantial scene structure. This is illustrated by the Image Reinterpretation panel.<h3 id="3.-image-fusion">3. Image fusion</h3>Use two reference images with only a very short or weak text prompt.In this mode, Ideogram can synthesise a coherent new scene from structural elements contributed by both images. This is more than simple blending: often, the model builds a new consistent world out of both references. This is illustrated by the Image Fusion panel.<h2 id="required-custom-nodes">Required custom nodes</h2>Main dependencies:<ul><li>ComfyUI-Krea2TextEncoder (<code>comfyui-krea2-text-encoder</code>)</li><li>rgthree-comfy</li><li>ComfyUI-KJNodes</li><li>WAS-NS</li><li>ComfyUI-Crystools</li></ul>Optional:<ul><li>A Person Mask Generator (<code>a-person-mask-generator</code>)</li></ul>The optional Person Mask Generator nodes can simply be removed without affecting the core workflow.<h2 id="limitations-and-observations">Limitations and observations</h2>This is an experimental technique, not a dedicated image-editing workflow.Some practical limitations:<ul><li>exact geometry is not guaranteed,</li><li>details may drift,</li><li>text inside reference images is usually not reproduced faithfully,</li><li>multiple reference images can interact in unexpected ways.</li></ul>A few important observations:<ul><li>Strong model priors matter. Famous or highly recognisable images may trigger strong internal biases.</li><li>Two-reference behaviour is not always simple blending. The model may invent its own semantic relationship between the references.</li><li>Parameter effects are not fully linear. Small changes can sometimes noticeably alter the interpretation.</li><li>High visual detail can require lower vision branch weight. Otherwise the text prompt may lose too much influence.</li></ul>In short: the workflow is powerful, but it remains exploratory and benefits from experimentation.<h2 id="acknowledgements">Acknowledgements</h2>Special thanks to ethanfel for the Krea2 text encoder implementation that provides the Qwen3-VL-based visual-conditioning path used by this workflow.Thanks also to:<ul><li>the ComfyUI developers for Ideogram V4 support,</li><li>rgthree for rgthree-comfy and especially the Power Puter used for the sigma logic,</li><li>the developers of KJNodes, WAS-NS, Crystools, and "A Person Mask Generator" for the utility nodes used in the workflow.</li></ul>The actual workflow idea explored here includes:<ul><li>visual guidance for Ideogram V4,</li><li>selective reference preprocessing,</li><li>sigma-dependent delayed visual guidance,</li><li>and weighted combination of text-only conditioning with text+visual conditioning.</li></ul><h2 id="final-note">Final note</h2>This workflow is meant as a practical and compact experiment in visual prompting / visual guidance for Ideogram V4.If you try it, I recommend:1. start with the notes already embedded in the workflow,2. begin with moderate parameter settings,3. and then experiment freely when the model’s own priors dominate too much.Have fun!

Files with SHA256: 883c487924cda6f9da068891d699929882a5fa4629cf117180b91fbea20d961c