🎯 HiTem3D Generator

This is the flagship of the whole pack. You feed it a front-view image, it calls the HiTem3D API, and a few minutes later you get back a URL to a real, downloadable 3D mesh in GLB, OBJ, STL, FBX, or USDZ. No local model, no GPU grind, no half-terabyte checkpoint to babysit - the heavy lifting happens on HiTem3D's servers, and you pay for it in API credits.

That last bit is the thing to understand before you get excited. HiTem3D is a paid cloud service, not a local model like Trellis or Hunyuan 3D. Community threads rate it as one of the best image-to-mesh generators out there - the r/StableDiffusion "Hitem3D currently best mesh generator?" post (+185) got serious praise for output quality, with people remeshing the results in ZBrush for real game assets. The same threads grumble about the obvious stuff: it's closed, it's not local, and free credits are stingy ("you get a couple models and that's it"). So this node is for when you want production-quality meshes and are okay with per-generation cost, not for free local tinkering.

How it works

The node takes a ComfyUI IMAGE tensor, squeezes off the batch dimension, converts it to JPEG bytes, and sends it to the HiTem3D API as a generation task. Then it polls until the task finishes and hands back three strings: model_url, cover_url, and task_id. There's no geometry math happening on your machine - the "model" dropdown is the API's model version, not a file you download.

One honest gotcha: the node reads its credentials from the config file, so make sure your keys are in config.json (or saved there via the Config node with save_config on) before you queue anything. If the API errors, the node rewrites the error into something human-readable - you'll see "INSUFFICIENT CREDITS", "INVALID API CREDENTIALS", or "TIMEOUT" right in the widget, which saves you a log dive.

The inputs that matter

Only one is required:

• front_image - a standard ComfyUI image. That's it for a bare minimum.

Everything else is optional but worth a glance:

• back_image, left_image, right_image - more angles mean a more complete mesh. Multi-view costs more credits, so start with front-only to test.
• model - hitem3dv1, hitem3dv1.5 (the default and the one to reach for), hitem3dv2.0, or scene-portraitv1.5 for character/portrait work.
• resolution - 512, 1024, 1536, or 1536pro. Bigger is slower and pricier. Start at 512.
• output_format - glb is the sensible default for previewing; obj/fbx for DCC pipelines; stl for 3D printing; usdz if you need Apple's format.
• generation_type - geometry_only, staged, or all_in_one (default).
• face_count - 100k to 2M. High poly is prettier, slower, and harder to work with.
• timeout - default 900 seconds. Bump it for 1536/1536pro jobs.

Wiring it up

The outputs are simple strings, so the pipeline is: HiTem3DNode → model_url into the HiTem3D Downloader → model_path into the HiTem3D 3D Preview. task_id is handy for tracking and for the History node. The example workflows in the pack's examples/ folder (like hitem3d_basic_workflow.json) show the exact pattern.

Installing

Grab the pack via ComfyUI Manager (search "ComfyUI HiTem3D Integration"), or:

cd ComfyUI/custom_nodes
git clone https://github.com/GeekatplayStudio/comfyui-hitem3d
cd comfyui-hitem3d
pip install -r requirements.txt

Then restart ComfyUI. Dependencies are light - just requests and Pillow beyond what ComfyUI already has; there are no model files to download. After that: get an access key + secret key from hitem3d.ai, add credits, and configure them in the Config node or config.json.

Where people get burned

• "Insufficient balance" / 余额不足 - you're out of credits. Purchase more at hitem3d.ai. Budget roughly 1–2 credits at 512, 3–5 at 1024, more at 1536.
• "Invalid credentials" - check the access/secret keys actually made it into the config file.
• Timeouts - raise timeout or drop to a lower resolution and fewer faces.
• Oversized input - the API caps images at 20MB and four views, PNG/JPEG/WebP only.

It's a paid, cloud-based tool, so it's never going to be the free local option - but if you need a clean mesh without managing a local 3D model, this is the easiest path from ComfyUI to a file you can drop in Blender.