本页由英文机器翻译而成。阅读英文原文。

Hunyuan3D-2.1 Shape(本地 3D 模型)

官方3DGPUv1.0.3aigd.model3d-hunyuan3d-2-1-shape
安装 还没安装应用?免费下载
或从终端安装
gamedev pkg add aigd.model3d-hunyuan3d-2-1-shape
在你的电脑上运行。 只需下载一次模型,之后即可在这台电脑的 GPU 上生成。

概览

本地图像转 3D:腾讯 Hunyuan3D-2.1 的形状模型可将一张图片变成高质量的无贴图 3D 网格(GLB),适用于游戏道具和角色,运行在你的 NVIDIA GPU 上,需要 10 GB 或以上显存。在 Local Python models runtime 中离线运行。未在欧盟、英国或韩国获得许可。

NVIDIA 10 GB 及以上

Hunyuan3D-2.1 Shape 可在你的 NVIDIA GPU(10 GB 或以上显存)上把一张图片变成高质量的 3D 形状,使用的是腾讯 Hunyuan3D-2.1 的形状模型。输出结果是无贴图的 GLB 网格。在 AI Game Dev 中,它通过 Local Python models runtime(aigd.python)本地运行。它适合希望为道具和角色获得精细基础网格、之后再另行贴图的开发者。它未在欧盟、英国或韩国获得许可。

你可以制作什么

  • 从单张概念图生成道具、武器、家具、生物和角色的无贴图 3D 网格。
  • 可供之后在你自己的工具中或用其他软件包贴图、重拓扑或绑定的基础网格。
  • 从概念原画快速搭建 3D 粗模。

示例请求

  • “用 Hunyuan3D 把 Concepts/treasure_chest.png 变成 3D 模型。”
  • “用这张剑的图片(透明背景)生成一个 3D 形状。”
  • “为刚添加的角色概念图生成网格。”

亮点

模型 IDaigd.model3d-hunyuan3d-2-1-shape.v1
操作图像转 3D(单张输入图像)
输出无贴图 GLB
步数默认 50
运行于NVIDIA GPU(CUDA),10 GB 或以上显存
下载约 7.4 GB,首次加载时另需运行时的 Python 环境
许可Tencent Hunyuan 3D 2.1 Community License:不适用于欧盟、英国或韩国;月活跃用户超过 100 万需另行获得许可

其他本地图像转 3D 模型

运行方式

不包含 Hunyuan3D-2.1 的 PBR 贴图模型。 它需要在你的电脑上编译自定义 CUDA 光栅化器,并把 Blender 作为 Python 模块使用,而应用的运行时不执行这些操作。请使用带有透明背景的单个物体图片。检查点是一个 PyTorch 文件,仅作为张量加载(weights_only=True),绝不会作为代码执行。

输出中可能包含一些小的分离部件:在对 TripoSG、Step1X-3D 和 Hunyuan3D 的 GPU 检查中,主体部分占面数的 97.5–99.2%。

此包只包含数据。它需要 Local Python models runtime(aigd.python),后者会在首次加载时为模型构建一个独立的 Python 环境(几 GB 的 PyTorch 和依赖库,详见该包的 README)。模型离线运行;其权重仅来自下面列出的文件,经你确认后从 Hugging Face 下载。AI Game Dev 不托管这些文件。

下载内容

约 7.4 GB,通过 Hugging Face 修订版本和 sha256 固定:

文件大小许可来源
hunyuan3d-dit-v2-1-config.yaml0.00 GBTencent Hunyuan 3D 2.1 Community License文件
hunyuan3d-dit-v2-1-model.fp16.ckpt7.37 GBTencent Hunyuan 3D 2.1 Community License文件

模型的 Python 代码从 GitHub 按固定的提交下载,每个文件均通过 sha256 校验。

许可

  • 权重与推理代码:Tencent Hunyuan 3D 2.1 Community License(许可、模型卡;代码 hy3dshape/ 来自 GitHub,提交为 82920d6)。

hy3dshape 的文件头提到“非商业”许可;但仓库中的 LICENSE(见上)是 Community License,适用的是后者。

必须的署名(Notice):"Tencent Hunyuan 3D 2.1 is licensed under the Tencent Hunyuan 3D 2.1 Community License Agreement, Copyright © 2025 Tencent. All Rights Reserved. The trademark rights of "Tencent Hunyuan" are owned by Tencent or its affiliate."

限制:

  • 未在欧盟、英国或韩国获得许可。 你不得在这些地区使用该模型或其输出。
  • 月活跃用户超过 100 万的产品或服务需要获得腾讯的单独许可。
  • 不得将该模型及其输出用于改进任何其他 AI 模型。
  • 适用腾讯的可接受使用政策。

你有责任确认你的使用方式是被允许的。

版本

Hunyuan3D-2.1 Shape(本地 3D 模型) 的发布版本
版本发布时间需要应用
1.0.3最新0.32.0-beta.6 或更高版本
1.0.20.32.0-beta.6 或更高版本

安装

在桌面应用中安装

打开包窗口(状态栏中的包图标),选择浏览,搜索 aigd.model3d-hunyuan3d-2-1-shape,然后点击添加到项目。

还没安装应用?免费下载 AI Game Dev,支持 Windows、macOS 和 Linux。

从终端安装

在项目文件夹中使用 gamedev CLI:

gamedev pkg add aigd.model3d-hunyuan3d-2-1-shape

环境要求

  • AI Game Dev 0.32.0-beta.6 或更高版本
  • NVIDIA GPU,10 GB 显存或以上

进一步了解包

安装
gamedev pkg add aigd.model3d-hunyuan3d-2-1-shape