Hunyuan3d 2mini

🚀 混元3D-2（Hunyuan3D-2）

本項目旨在實現每個人在創建和操作3D資產方面的想象，提供了用於高分辨率紋理3D資產生成的模型。

“ 實現每個人在創建和操作3D資產方面的想象。”

本倉庫包含論文 混元3D 2.0：用於高分辨率紋理3D資產生成的擴散模型擴展 中的模型。

混元3D-2mini 包含一個0.6B的形狀生成器，比 之前的1.1B版本 更小、更快。

🚀 快速開始

以下是一個簡單的使用示例：

from hy3dgen.shapegen import Hunyuan3DDiTFlowMatchingPipeline
pipeline = Hunyuan3DDiTFlowMatchingPipeline.from_pretrained(
    'tencent/Hunyuan3D-2mini',
    subfolder='hunyuan3d-dit-v2-mini',
    use_safetensors=True,
    device='cuda'
)
mesh = pipeline(
    image=image,
    num_inference_steps=30,
    octree_resolution=380,
    num_chunks=20000,
    generator=torch.manual_seed(12345),
    output_type='trimesh'
)[0]

有關代碼和更多使用細節，請參考 GitHub倉庫。

💻 使用示例

基礎用法

from hy3dgen.shapegen import Hunyuan3DDiTFlowMatchingPipeline
pipeline = Hunyuan3DDiTFlowMatchingPipeline.from_pretrained(
    'tencent/Hunyuan3D-2mini',
    subfolder='hunyuan3d-dit-v2-mini',
    use_safetensors=True,
    device='cuda'
)
mesh = pipeline(
    image=image,
    num_inference_steps=30,
    octree_resolution=380,
    num_chunks=20000,
    generator=torch.manual_seed(12345),
    output_type='trimesh'
)[0]

高級用法

目前文檔未提供高級用法示例，你可以參考 GitHub倉庫 獲取更多信息。

🔗 BibTeX

如果你覺得本倉庫有幫助，請引用我們的報告：

@misc{hunyuan3d22025tencent,
    title={Hunyuan3D 2.0: Scaling Diffusion Models for High Resolution Textured 3D Assets Generation},
    author={Tencent Hunyuan3D Team},
    year={2025},
    eprint={2501.12202},
    archivePrefix={arXiv},
    primaryClass={cs.CV}
}

@misc{yang2024tencent,
    title={Tencent Hunyuan3D-1.0: A Unified Framework for Text-to-3D and Image-to-3D Generation},
    author={Tencent Hunyuan3D Team},
    year={2024},
    eprint={2411.02293},
    archivePrefix={arXiv},
    primaryClass={cs.CV}
}

🔧 社區資源

感謝社區成員的貢獻，以下是混元3D 2.0的一些優秀擴展：

• ComfyUI-混元3D包裝器
• 適用於Windows的混元3D-2
• 📦 適用於Windows的運行包 | 整合包

👏 致謝

我們感謝 DINOv2、Stable Diffusion、FLUX、diffusers 和 HuggingFace 倉庫的貢獻者，感謝他們的開放研究和探索。

📄 許可證

本項目採用 tencent-hunyuan-community 許可證。