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.
Run it from TypeScript or Python with the Comfy SDK. The same code targets Comfy Cloud or a ComfyUI you host yourself — only the base URL changes.
// Install (beta)
npm i @comfyorg/sdk
// Run "Huyuan3D: Model Retopology and UV Unwrapping" (TypeScript)
import { Comfy } from "@comfyorg/sdk";
const client = new Comfy({ apiKey: "comfyui-..." });
// This workflow, exported in API format (see note below)
const wf = await client.workflows.fromFile("api_hunyuan3d_retopo_uv_api.json");
const job = await client.run(wf);
await job.getOutputs("268")[0].toFile("output.png"); // SaveGLBThe SDK takes a workflow in API format: open this workflow in ComfyUI and use File → Export Workflow (API).
Comfy Cloud API access requires a plan with an API key.
FAQ
