How to Build a 3D Asset Pipeline with Hunyuan3D 2.1 and Blender

You can turn Hunyuan3D 2.1 into a batch asset pipeline that outputs engine-ready GLB files with LODs in a single script. The trick is automating the Blender cleanup that most people do by hand.

Generating one model by hand is a novelty. Generating 200 props for a game level is a pipeline problem — and the manual cleanup is where all the time goes. Here’s how to cut it down.

Why Bother Batching?

Because the model is fast and your hands are slow. A single generation takes 30-60 seconds; the manual retopo, normal fixing, and export in Blender takes ten minutes. At 200 assets that’s 33 hours of clicking versus an hour of scripting.

The pipeline also gives you consistency: every asset gets the same scale, the same UV layout rules, the same LOD levels.

What Does the Pipeline Look Like?

• Stage 1 — Generate: loop a folder of reference images through the model via its CLI or API.
• Stage 2 — Clean: a headless Blender script recalculates normals, welds vertices, and removes interior geometry.
• Stage 3 — Decimate: produce LOD1 (50%) and LOD2 (25%) copies automatically.
• Stage 4 — Export: write GLB files with a naming convention your engine importer expects.

How Do You Script the Blender Cleanup?

1. Run Blender in background mode with -b -P cleanup.py.
2. In the script, enable the mesh cleanup operators and run recalc_normals first — it fixes most shading weirdness.
3. Add a Decimate modifier at 0.5 and 0.25, apply, and save each as a separate GLB.
4. Set the object scale to a fixed unit so assets import at consistent size.

Keep the raw generated mesh. You’ll want to re-run the clean pass when you change your decimation targets.

Where Does the Pipeline Break?

Input quality is the choke point. One bad reference image — object merged with background, harsh shadow — produces a mesh that no script can fix. Filter your inputs before the batch run, not after.

Texture resolution is the other limit. At 16GB VRAM you’re capped at lower texture sizes, which shows on hero assets. Reserve your best hardware for the pieces players actually get close to.

Who Should Build This?

Small studios and solo devs shipping environments, AR apps, or configurators. If you make fewer than 20 assets a month, the scripting overhead isn’t worth it — just do them by hand and skip the ceremony.

Quick Summary

• Batching Hunyuan3D 2.1 turns hours of clicking into one script run.
• Use headless Blender for normals, welding, decimation, and LOD export.
• Filter reference images first; bad inputs can’t be fixed downstream.
• Worth it above ~20 assets/month, overkill below that.