Huyuan3D 워크플로는 3D 모델 최적화 과정을 간소화하도록 설계되어, 게임 개발자와 3D 아티스트에게 특히 유용합니다. 이 워크플로는 리토폴로지와 UV 언랩이라는 두 가지 핵심 단계를 중심으로, 실시간 환경에서 효율적인 렌더링을 위한 모델 준비를 지원합니다. Hunyuan3D 모델을 활용해 AI 또는 포토그래메트리로 생성된 고밀도 메시를 가벼운 모델로 변환하고, 최적화된 토폴로지와 언랩된 UV를 생성합니다. 이는 TencentModelTo3DUVNode 및 TencentSmartTopologyNode를 포함한 특화 노드 시리즈로 수행됩니다. TencentModelTo3DUVNode는 복잡한 모델을 UV 처리에 적합한 형식으로 변환하고, TencentSmartTopologyNode는 디테일을 과도하게 손상시키지 않으면서 성능을 위한 토폴로지 최적화를 보장합니다. 마지막으로 SaveGLB 노드로 널리 호환되는 형식으로 내보낼 수 있으며, Load3D 노드는 고밀도 메시의 초기 가져오기를 담당합니다.
API
코드에서 이 워크플로우 사용하기
모든 Comfy 워크플로우는 JSON 그래프입니다. 아래 페이로드는 이 워크플로우 그 자체로, ComfyUI에서 실행되는 것과 동일합니다 — URL에서 가져오거나, 버전 관리에 보관하거나, ComfyUI에서 불러와 노드별로 실행할 수 있습니다.
Comfy SDK로 TypeScript 또는 Python에서 실행하세요. 동일한 코드는 Comfy Cloud 또는 직접 호스팅하는 ComfyUI 모두에 적용됩니다 — 기본 URL만 다릅니다.
// Install (beta)
npm i @comfyorg/sdk
// Run "Huyuan3D: 모델 리토폴로지 및 UV 전개" (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"); // SaveGLBSDK는 API 형식의 워크플로우를 사용합니다: 이 워크플로우를 ComfyUI에서 열고 파일 → 워크플로우 내보내기(API)를 사용하세요.
FAQ















