The 'HY 3D: Image to Model' workflow in ComfyUI is a powerful tool designed to convert 2D images into detailed 3D models, complete with geometry and PBR (Physically Based Rendering) textures. This workflow leverages the Hunyuan3D model, known for its advanced capabilities in interpreting image data and generating accurate 3D representations. The process begins with the LoadImage node, which allows users to upload their desired image. The core transformation is handled by the TencentImageToModelNode, which processes the image data and constructs a 3D model. This node utilizes sophisticated algorithms to ensure that the resulting model maintains high fidelity to the original image's features.
Once the model is generated, the SaveGLB node is used to export the model in the GLB format, which is widely supported for 3D assets and ensures easy integration into various applications. Additionally, the Preview3D node provides a real-time visualization of the model, allowing users to inspect the geometry and textures before finalizing the output. This workflow is particularly useful for artists and developers looking to quickly prototype 3D assets from existing 2D designs, offering a seamless transition from concept to 3D model.
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 "HY 3D: Image to Model" (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"); // 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
