Save 4 hours! We auto-setup your workflow! Free!

Drop your workflow.json — we handle every dependency, custom node, and model. Just open the link and run.

Auto-Setup Workflow Json (Free) Now!
ComfyUI > Nodes > ComfyUI-HunyuanImage3 > HunyuanImage-3.0 DyPE

ComfyUI Node: HunyuanImage-3.0 DyPE

Class Name

HunyuanImage3DyPE

Category
model/patch/hunyuan image 3
Author
PedroMarinhoDev (Account age: 43days)
Extension
ComfyUI-HunyuanImage3
Latest Updated
2026-11-03
Github Stars
0.04K

How to Install ComfyUI-HunyuanImage3

Install this extension via the ComfyUI Manager by searching for ComfyUI-HunyuanImage3
  • 1. Click the Manager button in the main menu
  • 2. Select Custom Nodes Manager button
  • 3. Enter ComfyUI-HunyuanImage3 in the search bar
After installation, click the Restart button to restart ComfyUI. Then, manually refresh your browser to clear the cache and access the updated list of nodes.

Visit ComfyUI Online for ready-to-use ComfyUI environment

  • Free trial available
  • 16GB VRAM to 80GB VRAM GPU machines
  • 400+ preloaded models/nodes
  • Freedom to upload custom models/nodes
  • 200+ ready-to-run workflows
  • 100% private workspace with up to 200GB storage
  • Dedicated Support

Run ComfyUI Online

HunyuanImage-3.0 DyPE Description

Patches HunyuanImage-3.0 with dynamic position extrapolation for generation above 1024 × 1024.

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 ntk preset; 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 model connection 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.

HunyuanImage-3.0 DyPE Related Nodes

Go back to the extension to check out more related nodes.
ComfyUI-HunyuanImage3
RunComfy
Copyright 2025 RunComfy. All Rights Reserved.

RunComfy is the premier ComfyUI platform, offering ComfyUI online environment and services, along with ComfyUI workflows featuring stunning visuals. RunComfy also provides AI Models, enabling artists to harness the latest AI tools to create incredible art.

HunyuanImage-3.0 DyPE