The Huyuan3D workflow is designed to streamline the process of optimizing 3D models, making it particularly beneficial for game developers and 3D artists. This workflow focuses on retopology and UV unwrapping, two critical steps in preparing models for efficient rendering in real-time environments. By utilizing the Hunyuan3D model, this workflow takes a dense mesh—often generated through AI or photogrammetry—and transforms it into a lightweight model with optimized topology and unwrapped UVs. This is achieved through a series of specialized nodes including the TencentModelTo3DUVNode and TencentSmartTopologyNode. The TencentModelTo3DUVNode is responsible for converting complex models into a format suitable for UV processing, while the TencentSmartTopologyNode ensures the model's topology is optimized for performance without sacrificing detail. Finally, the SaveGLB node allows users to export the processed model in a widely compatible format, and the Load3D node facilitates the initial import of the dense mesh.
API
Use this workflow from code
Every Comfy workflow is a JSON graph. The payload below is this workflow, exactly as ComfyUI runs it — fetch it from the URL, keep it in version control, or load it in ComfyUI and run it node by node.
GET https://comfy.org/workflows/download/2318d5c3d250.jsonFetching workflow JSON…
Run it from Python or TypeScript with the Comfy SDK. The same code targets Comfy Cloud or a ComfyUI you host yourself — only the base URL changes.
# Install (beta)
pip install comfy-sdk # Python
npm i @comfyorg/sdk # TypeScript
# Run "Huyuan3D: Model Retopology and UV Unwrapping" (Python)
from comfy_sdk import Comfy
client = Comfy(api_key="comfyui-...")
# This workflow, exported in API format (see note below)
wf = client.workflows.from_file("api_hunyuan3d_retopo_uv_api.json")
job = client.run(wf)
for output in job.get_outputs("268"): # SaveGLB
output.to_file(output.name)The SDK takes a workflow in API format: open this workflow in ComfyUI and use File → Export Workflow (API). API access requires a Comfy Cloud plan with an API key. SDK docs · Get an API key
FAQ
