HunyuanImage-3.0 DyPE:
HunyuanImage3DyPE, displayed in ComfyUI as “HunyuanImage-3.0 DyPE,” enables dynamic position extrapolation for HunyuanImage-3.0 generation at resolutions larger than 1024 × 1024. Position information helps the model understand where visual elements belong within an image; DyPE adjusts how that information is interpreted as generation progresses. Specifically, the rotary position encoding, or RoPE, rescaling starts at its default setting and gradually relaxes toward the model’s trained positions over the sampling steps. This is intended to preserve the overall composition you would get without DyPE while changing how details develop during the later steps. It provides an alternative detail-rendering behavior for larger images, rather than a guaranteed improvement for every prompt. Text tends to render better without this adjustment, and the node has no effect at or below 1024 × 1024. It is a model patch, not an image upscaler, and does not itself increase your image dimensions.
HunyuanImage-3.0 DyPE Input Parameters:
model
The required MODEL connection supplies the model to which the DyPE setting will be applied. For the intended behavior, connect the HunyuanImage-3.0 model used in your generation workflow. The node clones the supplied model wrapper and applies the configuration to that clone, allowing you to keep a separate unpatched model connection for comparison. It does not generate an image or retrain the model; it prepares the model configuration for later sampling. The execution code does not check the model architecture, so accepting a MODEL connection alone does not establish that another model supports this feature. There is no numeric minimum, maximum, selectable option, or default value for this connection; you must supply a model.
preset
The required COMBO setting selects the DyPE preset written into the model’s transformer options. The only available option is ntk, which is also the default. Selecting it sets the internal hy3_dype option to ntk, allowing the supporting HunyuanImage-3.0 implementation to use that DyPE behavior during generation. In practical terms, this enables the dynamic positional adjustment described above without requiring you to configure its underlying calculations. The node exposes no strength control, scheduling controls, or alternative presets, and the supplied source does not define the preset’s mathematical details. Minimum and maximum values do not apply because this is a fixed-choice setting. There is no disabled option; to compare against ordinary generation, use the model connection before this patch.
HunyuanImage-3.0 DyPE Output Parameters:
MODEL
The MODEL output is the cloned model with the DyPE preset added to its transformer options. Connect it to the model input of the sampling stage in your HunyuanImage-3.0 workflow so that the configured behavior can take effect during generation. Internally, the relevant setting is hy3_dype, stored under transformer_options. This output is a configured model connection, not a rendered image, latent image, or numerical quality score. Its importance is that it carries the patch forward into the generation process; if your sampler continues to use the original model connection, this node’s configuration will not affect that sampling branch. At or below 1024 × 1024, the documented behavior is unchanged even when you use this output.
HunyuanImage-3.0 DyPE Usage Tips:
- Place the node between your HunyuanImage-3.0 model-loading stage and the sampling stage. Check that the sampler uses this node’s MODEL output rather than the original model connection.
- Use the default
ntkpreset; it is the only supported choice exposed by this node. There are no additional DyPE controls to tune here. - Test it on a larger square image, such as 1536 × 1536, to evaluate its intended high-resolution behavior. Set the image dimensions elsewhere in your workflow, because this node does not control resolution.
- Compare patched and unpatched generations using the same prompt, seed, resolution, sampler, and step count. Look especially at fine details, since the documented difference concerns late-step detail rather than a new composition.
- For posters, signs, labels, or other images where readable lettering is important, test the unpatched model first. The node description specifically notes that text tends to come out better without DyPE.
- Do not expect a visible change at 1024 × 1024 or below. If that is your target resolution, bypassing the node avoids an unnecessary configuration step.
- Keep high-resolution resource requirements in mind. This node is not documented as a memory-saving patch, so use dimensions that your existing workflow and hardware can handle.
HunyuanImage-3.0 DyPE Common Errors and Solutions:
Required model input is missing
- Explanation: The
modelconnection is required. Without it, the node has no model to clone or configure. ComfyUI may report this during workflow validation; the exact message depends on your installed version. - Solution: Connect a valid HunyuanImage-3.0 MODEL output to
model, then run the workflow again.
Possible execution error: 'NoneType' object has no attribute 'clone'
- Explanation: The node immediately calls
model.clone(). If an invalid upstream result supplies no model and execution reaches this line, a Python attribute error of this kind can occur. This is a possible runtime error, not a custom message defined by the node. - Solution: Check the upstream model loader for errors and confirm that it returns a valid MODEL connection. Do not connect image, latent, or conditioning data in place of a model.
No visible difference after enabling DyPE
- Explanation: This is a troubleshooting symptom rather than an error message. DyPE has no effect at or below 1024 × 1024, and at larger sizes its documented changes concern late-step detail rather than overall composition. The patch also cannot affect sampling if the sampler still uses the original model.
- Solution: Test above the documented resolution threshold, confirm that the sampler receives this node’s output, and compare results with otherwise identical settings. Inspect fine details rather than expecting a substantially different layout.
Text looks worse with DyPE enabled
- Explanation: This is a documented trade-off, not necessarily a workflow failure. The node description states that text tends to come out better without DyPE.
- Solution: Bypass the node for text-heavy images and compare results using the same prompt and seed. Prefer the unpatched model when it produces clearer lettering.
DyPE appears ineffective with a different model architecture
- Explanation: The patch writes a HunyuanImage-3.0-specific transformer option but does not validate architecture compatibility. Another model may not use that option, so a successful node execution does not guarantee that DyPE is active.
- Solution: Use this node with its intended HunyuanImage-3.0 workflow. For other model families, use positional-adjustment tools explicitly documented for those models.
