Hunyuan3D

Hunyuan3D-2 is Tencent's open-weight system for high-resolution textured 3D assets. It works in two stages: Hunyuan3D-DiT builds geometry from a condition image, and Hunyuan3D-Paint creates detailed texture maps. It handles image-to-3D, text-to-3D through an API server, and texturing of your own meshes. Shape generation needs 6 GB of VRAM; shape plus texture needs 16 GB. Code and weights are public under Tencent's community license, which carries regional and use restrictions. Interfaces include a Python API, a Gradio app, a server mode, and a Blender addon. Read the license file first.

Key Features

1. Two-Stage Pipeline

Hunyuan3D-DiT, a flow-based diffusion transformer, creates geometry aligned to a condition image. Hunyuan3D-Paint then synthesizes high-resolution texture maps.

2. Three Generation Modes

Generate from images or text, or texture only. Text prompts run through the API server; your own handcrafted meshes can skip geometry.

3. Model Zoo

Pick from DiT 2.0, 2mini, 2mv multiview, and 2.1, plus distilled Turbo and Fast variants. Paint models come in matching versions.

4. Cross-Platform Support

Runs on macOS, Windows, and Linux from the same codebase. Pick the platform your studio already uses.

5. Low-VRAM Gradio Mode

The Gradio app includes a low-VRAM mode for smaller GPUs. Try full quality on big cards, lighter mode elsewhere.

6. Blender Addon

A Blender addon connects the models to a popular 3D suite. Generate and texture without leaving your workflow.

Frequently Asked Questions (FAQ)

Which model should I download?

2mini is smallest and fastest, 2mv handles multiview input, and 2.1 is the largest at 3.0B parameters. Turbo and Fast are distilled for speed.

Can I texture my own mesh?

Yes. The texture-only mode applies Hunyuan3D-Paint to handcrafted meshes without generating new geometry.

What does the license actually allow?

The Tencent Hunyuan 3D 2.0 Community License is not an OSI open-source license. It excludes the EU, UK, and South Korea and adds an acceptable-use policy, so read it before use.

Is there a hosted version I can try?

Yes, Hunyuan3D Studio exists as a hosted demo. Its pricing is not stated on the official page, so confirm there.

Where do I get the code?

From the Tencent-Hunyuan/Hunyuan3D-2 GitHub repo. The old Tencent org URL now redirects there.

Conclusion

Hunyuan3D-2 brings Tencent's two-stage 3D generation to open weights. Geometry plus texture models cover image-to-3D, text-to-3D, and retexturing. It suits developers, artists, and researchers with capable GPUs. The community license is not standard open-source, so read it first. A hosted Studio demo exists for quick tries without local setup. Check the GitHub repo for models and guides.