ComfyUI > Nodes > ComfyUI > Hunyuan3D: Smart Topology

ComfyUI Node: Hunyuan3D: Smart Topology

Class Name

TencentSmartTopologyNode

Category
api node/3d/Tencent
Author
ComfyAnonymous (Account age: 763days)
Extension
ComfyUI
Latest Updated
2026-05-13
Github Stars
112.77K

How to Install ComfyUI

Install this extension via the ComfyUI Manager by searching for ComfyUI
  • 1. Click the Manager button in the main menu
  • 2. Select Custom Nodes Manager button
  • 3. Enter ComfyUI 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

Hunyuan3D: Smart Topology Description

Smart retopology tool for 3D models, optimizing polygon count while preserving details and structure, supports GLB and OBJ formats up to 200MB.

Hunyuan3D: Smart Topology:

TencentSmartTopologyNode is designed to perform smart retopology on 3D models, making it an essential tool for artists working with high-poly models. This node is particularly beneficial for optimizing 3D models by reducing their polygon count while maintaining the essential details and structure. It supports models in GLB and OBJ formats, with a maximum file size of 200MB, making it suitable for handling complex and detailed models. The node's primary goal is to streamline the process of preparing 3D models for various applications, such as animation or real-time rendering, by converting them into more manageable and efficient forms without compromising on quality.

Hunyuan3D: Smart Topology Input Parameters:

model_3d

This parameter accepts the input 3D model in either GLB or OBJ format. It is crucial as it serves as the base model on which the smart retopology process will be performed. The node can handle models up to 200MB in size, making it suitable for high-poly models that require optimization.

polygon_type

This parameter allows you to choose the surface composition type for the retopologized model. You can select between "triangle" and "quadrilateral" options. The choice of polygon type can affect the model's appearance and performance in different applications, with triangles often being preferred for real-time rendering and quadrilaterals for animation.

face_level

This parameter determines the level of polygon reduction applied to the model. You can choose from "medium," "high," or "low" levels, which correspond to different degrees of simplification. Selecting a higher reduction level will result in a model with fewer polygons, which can improve performance but may also lead to a loss of detail.

seed

The seed parameter is an integer value that influences the non-deterministic aspects of the retopology process. It has a default value of 0 and can range from 0 to 2147483647. While the results are non-deterministic regardless of the seed value, changing the seed can lead to variations in the output, allowing for experimentation with different retopology outcomes.

Hunyuan3D: Smart Topology Output Parameters:

OBJ

The output parameter is an OBJ file, which is the retopologized version of the input 3D model. This output is crucial as it provides a more optimized and efficient version of the original model, suitable for various applications such as animation, gaming, or virtual reality. The OBJ format is widely supported and can be easily imported into most 3D software.

Hunyuan3D: Smart Topology Usage Tips:

  • For models intended for real-time applications, consider using the "triangle" polygon type to ensure compatibility with game engines.
  • Experiment with different face levels to find the right balance between model detail and performance, especially if the model will be used in resource-constrained environments.

Hunyuan3D: Smart Topology Common Errors and Solutions:

File size exceeds 200MB

  • Explanation: The input model file is larger than the maximum allowed size of 200MB.
  • Solution: Reduce the file size by simplifying the model or splitting it into smaller parts before processing.

Unsupported file format

  • Explanation: The input model is not in GLB or OBJ format.
  • Solution: Convert the model to a supported format using 3D modeling software before using the node.

Invalid seed value

  • Explanation: The seed value is outside the allowed range of 0 to 2147483647.
  • Solution: Ensure the seed value is within the specified range to avoid errors during processing.

Hunyuan3D: Smart Topology Related Nodes

Go back to the extension to check out more related nodes.
ComfyUI
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.

Hunyuan3D: Smart Topology