Earngenix Logo
Skip to main content

Workflow Blog · Beginner–Intermediate · Updated July 2026

Image to 3D in ComfyUI: Hunyuan3D 2.1 & Multi-View Guide

Turn one photo into a 3D model with Hunyuan3D 2.1, or four angles into a more accurate one with Multi-View — both free, both local, no login required.

Free

Cost

8 GB

Min VRAM

Beginner

Skill level

2.1 / 2.0mv

Models used

By Earngenix Team · · Tested on ComfyUI, RTX 4090

⚡ Quick Answer

To turn a photo into a 3D model in ComfyUI, use Hunyuan3D 2.1 for a single image, or Hunyuan3D 2.0 Multi-View for four angles (front, back, left, right) of the same object. Both run locally and are free — no login, no credits. Minimum 8 GB VRAM to run either.

Turning a single product photo into a usable 3D mesh used to mean learning photogrammetry or paying for a scanning service. In ComfyUI, Hunyuan3D 2.1 does it from one image, and Hunyuan3D 2.0 Multi-View does it more accurately from four. Both are free, local models — you download a checkpoint once and run everything on your own GPU.

This guide covers both workflows end to end: single-image generation, four-angle generation with a chair as the example, what to do if you only have one photo of your subject, and how to get the finished mesh into Blender.

What You Need

Tested on: ComfyUI (confirm your exact version in Help > About), RTX 4090 (24 GB VRAM) · Minimum VRAM: 8 GB (shape generation only — texture/paint steps need more)

Two model files cover both workflows in this guide. You only need to download the one for whichever workflow you run first.

Models Needed

Single image
hunyuan_3d_v2.1.safetensors~7.4 GB
Multi-view
hunyuan3d-dit-v2-mv_fp16.safetensors~4.9 GB

Download hunyuan_3d_v2.1.safetensors from Hugging Face and hunyuan3d-dit-v2-mv_fp16.safetensors from Hugging Face, then place both in ComfyUI/models/checkpoints/.

Folder structure showing both Hunyuan3D safetensors files inside ComfyUI/models/checkpoints/🔍 Click to zoom
Both model files sit directly inside ComfyUI/models/checkpoints/ — not in a subfolder.

No custom nodes required — both workflows use nodes built into ComfyUI core. New to ComfyUI entirely? Start with the ComfyUI installation guide, and see the checkpoint models guide if "checkpoint" is a new term for you.

Which Version Should You Use?

Hunyuan3D is a family of 3D generation models from Tencent. It reads a 2D image and outputs a mesh — a 3D shape made of connected points and faces, the same kind of file a game engine or 3D printer expects.

VersionInputRuns LocallyTextureBest For
Hunyuan3D 2.11 imageYes — freeYes (PBR)Fastest result, simple objects
Hunyuan3D 2.0 Multi-View2–4 imagesYes — freeNo (geometry only)Furniture, vehicles, anything with back/side detail
Hunyuan3D 3.0Text, image, or sketchNo — cloud APIYesText-to-3D, part decomposition, UV unwrap

Use single-image (2.1) when you only have one photo, or want a quick result with color and texture already applied. Use multi-view (2.0mv) when your subject has detail on more than one side — furniture, vehicles, anything that looks wrong if captured from the front alone. A single front photo of a chair gives Hunyuan3D no information about the backrest or side panels, so it has to guess. Four angles remove the guessing.

Warning: Multi-view generates geometry only. If you need a textured, colored result from multiple angles, generate the mesh with the multi-view workflow first, then apply a separate texturing step — that's outside the scope of this guide.

How to Turn One Photo Into a 3D Model (Hunyuan3D 2.1)

Skip the manual node-by-node build — download the ready-made workflow below and load it straight into ComfyUI.

Download Workflow JSON(hunyuan3d-2-1-single-image.json)
  1. Download the workflow JSON above, then drag it directly onto the ComfyUI canvas (or use Workflow > Open) to load it.
  2. Make sure hunyuan_3d_v2.1.safetensors is in ComfyUI/models/checkpoints/ — see the What You Need section above if you haven't downloaded it yet.
  3. On the Image Only Checkpoint Loader node, select hunyuan_3d_v2.1.safetensors from the dropdown if it isn't already selected.
  4. On the Load Image node, click the thumbnail and select your own photo.
  5. Click the orange Queue Prompt button. A 3D preview appears in the Save GLB node once generation finishes.
Image Only Checkpoint Loader node with hunyuan_3d_v2.1.safetensors selected🔍 Click to zoom
The Image Only Checkpoint Loader node with the Hunyuan3D 2.1 checkpoint selected.
Tip: Use an image with a plain, uncluttered background. Hunyuan3D reads the whole frame — a busy background gets interpreted as part of the object's shape.
🖱️ Drag to rotate · scroll to zoom
Result from a single front photo — drag to rotate, scroll to zoom.

How to Turn 4 Photos Into a More Accurate 3D Model (Multi-View)

This example uses a chair — a good test case because a single front photo can't show what the backrest, armrests, or rear legs look like.

Same approach as the single-image workflow — download the ready-made multi-view workflow below instead of building it node by node.

Download Workflow JSON(hunyuan3d-multiview.json)
  1. Gather four photos of the same chair: front, back, left, right. Keep the chair centered and roughly the same size in each shot, against a plain background.
  2. Download the workflow JSON above, then drag it directly onto the ComfyUI canvas (or use Workflow > Open) to load it.
  3. Make sure hunyuan3d-dit-v2-mv_fp16.safetensors is in ComfyUI/models/checkpoints/.
  4. On the Image Only Checkpoint Loader node, select hunyuan3d-dit-v2-mv_fp16.safetensors from the dropdown if it isn't already selected.
  5. On the four Load Image nodes (labeled Front, Back, Left, Right), click each thumbnail and add the matching angle photo. Double-check each photo lands on its correctly labeled node.
  6. Click Queue Prompt. Compare the result to the single-image version — the backrest and side profile should match your actual chair instead of being guessed.
Four Load Image nodes labeled Front, Back, Left, Right wired into their CLIP Vision Encode nodes🔍 Click to zoom
The four angle inputs, each labeled and wired into its own CLIP Vision Encode node.
Warning: Plugging an angle into the wrong input (for example, connecting your "left" photo into the "right" slot) won't cause an error — ComfyUI will run it anyway. The model will just build the mesh with the sides swapped. Double-check each connection against its label before queuing.
Tip: Don't have four real photos of your subject? Generate the missing angles instead with the Qwen multi-angle ComfyUI workflow — it takes one reference image and produces consistent front/back/left/right views you can drop straight into the four Load Image nodes above.
🖱️ Drag to rotate · scroll to zoom
Result from four angles of the same chair — geometry only, no texture applied.

How to Export Your 3D Model to Blender

  1. In the Save GLB node, open the export menu on the left side of the node's 3D preview.
  2. Choose GLB and save it. If you're running ComfyUI locally, the file also saves automatically to ComfyUI/output/3D/.
  3. Open Blender, go to File > Import > glTF 2.0 (.glb/.gltf), and select the exported file. The mesh loads into your scene at its generated scale.
Tip: Hunyuan3D exports with the "original" up-direction setting. If your model looks like it's lying on its side in Blender, rotate it 90° on the X-axis after import rather than regenerating.

Hunyuan3D 3.0 — What's New (and Why It's Not in This Guide)

Hunyuan3D 3.0 runs through ComfyUI as a cloud-based Partner Node rather than a local checkpoint. It adds text-to-3D generation, part decomposition, and automatic UV unwrapping — none of which the local 2.1/2.0mv models do. The tradeoff is that it requires a Comfy account and runs on credits instead of your own GPU, so it doesn't fit a "download once, run free" guide.

Want to try it anyway? The official Comfy documentation covers setup for the cloud version.

Troubleshooting

"This node type does not exist" (red node in workflow)

Every node in both workflows ships with ComfyUI core — this error means your ComfyUI install is out of date.

  1. Open ComfyUI Manager from the top menu.
  2. Click Update ComfyUI.
  3. Restart ComfyUI completely and reload the workflow.
Red node type does not exist error box in ComfyUI🔍 Click to zoom
The red error box that appears when a node type is missing or outdated.

The model file doesn't appear in the checkpoint dropdown

The .safetensors file isn't in the right folder, or it's misnamed.

  1. Confirm the file sits directly inside ComfyUI/models/checkpoints/ — not a subfolder.
  2. Confirm the filename matches exactly: hunyuan_3d_v2.1.safetensors or hunyuan3d-dit-v2-mv_fp16.safetensors.
  3. Click the refresh icon on the checkpoint loader node, or restart ComfyUI.

The output mesh is a blank or deformed blob

This almost always comes from the input image, not a settings problem.

  1. Check that your subject is on a plain, uncluttered background — busy backgrounds get read as part of the shape.
  2. Make sure the subject fills a reasonable portion of the frame — a tiny subject in a large image gives the model little to work with.
  3. For multi-view, confirm each angle is connected to its matching labeled input on the Hunyuan3Dv2ConditioningMultiView node.

Frequently Asked Questions

Yes. Hunyuan3D 2.1 and Hunyuan3D 2.0 Multi-View are both open checkpoint files you download once and run locally, with no login and no per-generation cost. Hunyuan3D 3.0 is the exception — it runs through a cloud API that requires an account and credits.

One image works with Hunyuan3D 2.1. Four images (multi-view) produce a more geometrically accurate mesh, especially for objects with detail on more than one side, like furniture or vehicles.

Shape generation runs on 8 GB VRAM for either version. Higher VAE Decode settings or larger batches increase that requirement.

Yes, once exported as GLB you can convert it to STL in Blender or a slicer that accepts GLB directly. Check wall thickness and closed geometry before printing — generated meshes sometimes have thin or open sections that need cleanup first.

No. Hunyuan3D 2.0 Multi-View outputs geometry only. Hunyuan3D 2.1 (single image) does include PBR texture in its output.

2.1 is a free local checkpoint you run on your own GPU. 3.0 is a cloud Partner Node that adds text-to-3D, part decomposition, and UV unwrapping, but requires a Comfy account and runs on credits instead of local hardware.

What to Do Next

Run the single-image workflow first, then move to multi-view.

Confirm your setup works with one clean photo, then try the four-angle workflow once you're comfortable with the node graph. For a structured path through the rest of ComfyUI's tools, see the full roadmap.

Published: 2026-07-31 · Last updated: 2026-07-31 · Model info verified against Comfy-Org Hugging Face repackaged checkpoints

Discussion

Join the discussion

Sign in to leave a comment or reply

💬

No comments yet

Be the first to share your thoughts!