ComfyUI의 'HY 3D: Image to Model' 워크플로는 2D 이미지를 지오메트리와 PBR(Physically Based Rendering) 텍스처가 포함된 디테일한 3D 모델로 변환하도록 설계된 도구입니다. 이 워크플로는 이미지 데이터를 해석하고 정확한 3D 표현을 생성하는 고급 기능으로 알려진 Hunyuan3D 모델을 활용합니다. 과정은 LoadImage 노드로 시작하며, 사용자가 원하는 이미지를 업로드할 수 있습니다. 핵심 변환은 TencentImageToModelNode가 처리하며, 이미지 데이터를 분석해 3D 모델을 구성합니다. 이 노드는 정교한 알고리즘을 사용해 결과 모델이 원본 이미지 특징을 높은 충실도로 유지하도록 합니다.
모델이 생성되면 SaveGLB 노드로 GLB 형식으로 내보냅니다. GLB는 3D 에셋에서 널리 지원되어 다양한 애플리케이션에 쉽게 통합할 수 있습니다. 또한 Preview3D 노드는 모델을 실시간으로 시각화해, 출력 확정 전에 지오메트리와 텍스처를 검사할 수 있게 합니다. 이 워크플로는 기존 2D 디자인에서 빠르게 3D 에셋을 프로토타이핑하려는 아티스트와 개발자에게 특히 유용하며, 콘셉트에서 3D 모델로 자연스럽게 전환할 수 있게 합니다.
API
코드에서 이 워크플로우 사용하기
모든 Comfy 워크플로우는 JSON 그래프입니다. 아래 페이로드는 이 워크플로우 그 자체로, ComfyUI에서 실행되는 것과 동일합니다 — URL에서 가져오거나, 버전 관리에 보관하거나, ComfyUI에서 불러와 노드별로 실행할 수 있습니다.
Comfy SDK로 TypeScript 또는 Python에서 실행하세요. 동일한 코드는 Comfy Cloud 또는 직접 호스팅하는 ComfyUI 모두에 적용됩니다 — 기본 URL만 다릅니다.
// Install (beta)
npm i @comfyorg/sdk
// Run "혼원3D: 이미지를 모델로" (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_image_to_model_api.json");
const asset = client.assets.fromFile("input.png");
wf.setInput("1", "image", asset); // LoadImage
const job = await client.run(wf);
await job.getOutputs("14")[0].toFile("output.png"); // SaveGLBSDK는 API 형식의 워크플로우를 사용합니다: 이 워크플로우를 ComfyUI에서 열고 파일 → 워크플로우 내보내기(API)를 사용하세요.
FAQ
