TripoSG 1.5B(本地 3D 模型)
gamedev pkg add aigd.model3d-triposg概览
本地图生 3D:VAST-AI 的 TripoSG 1.5B 可将一张图像变成细节丰富、表面锐利干净的无纹理 3D 网格(GLB),在你的 NVIDIA GPU 上运行,需 8 GB 显存。在 Local Python models runtime 中可离线运行。权重为 MIT;其推理代码中的部分 Tencent 代码在欧盟、英国和韩国未获许可。
TripoSG 1.5B 借助 VAST-AI 的 TripoSG,在你的 NVIDIA GPU(8 GB 或以上显存)上把一张图像变成细节丰富的 3D 形状。结果是一个表面锐利干净的无纹理 GLB。在 AI Game Dev 中,它通过 Local Python models runtime(aigd.python)在本地运行。在本地图生 3D 模型中,它的显存需求最低。其推理代码的一部分采用 Tencent 许可,不允许在欧盟、英国或韩国使用。
你可以制作什么
- 用一张图像生成道具、武器、载具、生物和角色的无纹理网格。
- 供后续贴图、重拓扑或绑定的基础网格。
- 在 8 GB 的 NVIDIA 显卡上,根据概念美术制作 3D 白模。
示例请求
- “用 TripoSG 为
Concepts/lantern.png制作一个 3D 模型。” - “把透明背景的机器人概念图转成 GLB。”
- “为
Concepts/rocks/中的三张岩石图片分别生成网格。”
亮点
| 模型 ID | aigd.model3d-triposg.v1 |
| 操作 | 图像转 3D(一张输入图像;透明背景效果最佳) |
| 输出 | 无纹理 GLB |
| 步数 | 默认 50 |
| 运行于 | NVIDIA GPU(CUDA),显存 8 GB 或以上 |
| 下载 | 约 7.9 GB,首次加载时另需运行时的 Python 环境 |
| 许可 | 权重 MIT;部分推理代码采用 Tencent 许可:不得在欧盟、英国或韩国使用,月活跃用户超过 100 万需另行取得许可 |
其他本地图生 3D 模型
- Hunyuan3D-2.1 Shape:无纹理,10 GB 显存。
- Step1X-3D Geometry:无纹理,16 GB 显存,Apache-2.0,无地域限制。
- TRELLIS.2 4B 和 Pixal3D:带 PBR 材质的纹理 GLB,在 NVIDIA 或 Vulkan GPU 上需 16 GB。
如何运行
请使用一张只包含一个物体、背景透明的图像:应用会将其裁剪到物体。不透明图像会整张使用,只有当物体占满纯色背景时才有效。未捆绑背景去除模型(TripoSG 自带的 RMBG-1.4 为非商业许可)。不使用更快的“flash”解码器:它需要 diso,该模型为非商业许可(CC BY-NC 4.0),且必须自行编译。
输出可能包含细小的分离部件:在针对 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.9 GB,按 Hugging Face 版本和 sha256 固定:
| 文件 | 大小 | 许可 | 来源 |
|---|---|---|---|
feature_extractor_dinov2-preprocessor_config.json | 0.00 GB | MIT | 文件 |
image_encoder_dinov2-config.json | 0.00 GB | MIT | 文件 |
image_encoder_dinov2-model.safetensors | 1.22 GB | MIT | 文件 |
model_index.json | 0.00 GB | MIT | 文件 |
scheduler-scheduler_config.json | 0.00 GB | MIT | 文件 |
transformer-config.json | 0.00 GB | MIT | 文件 |
transformer-diffusion_pytorch_model.safetensors | 5.76 GB | MIT | 文件 |
vae-config.json | 0.00 GB | MIT | 文件 |
vae-diffusion_pytorch_model.safetensors | 0.97 GB | MIT | 文件 |
模型的 Python 代码从 GitHub 按固定提交下载,每个文件都经 sha256 校验。
许可
- 权重:MIT,© 2025 VAST-AI-Research 及贡献者(模型卡)。
- 推理代码(
triposg/,从 GitHub 按提交fc5c409下载):仓库本身为 MIT,但其triposg/文件夹带有 Tencent Hunyuan FlashVDM Community License,其 NOTICE 列出了源自 Tencent Hunyuan FlashVDM 和 HunyuanDiT 的代码。
必需的署名:"TripoSG © 2025 VAST-AI-Research and contributors. Tencent Hunyuan FlashVDM is licensed under the Tencent Hunyuan FlashVDM Community License Agreement, Copyright © 2025 Tencent. All Rights Reserved. Tencent Hunyuan is licensed under the Tencent Hunyuan Community License Agreement, Copyright © 2024 Tencent. All Rights Reserved. The trademark rights of "Tencent Hunyuan" are owned by Tencent or its affiliate."
限制(来自覆盖部分推理代码的 Tencent 许可):
- 在欧盟、英国或韩国未获许可。 你不得在这些地区使用该代码或其输出。
- 月活跃用户超过 100 万的产品或服务需要向 Tencent 另行取得许可。
- 该代码及其输出不得用于改进任何其他 AI 模型。
- 适用 Tencent 的可接受使用政策。
你有责任确认你的使用方式是被允许的。
版本
| 版本 | 发布时间 | 需要应用 |
|---|---|---|
| 1.0.4最新 | 0.32.0-beta.6 或更高版本 | |
| 1.0.3 | 0.32.0-beta.6 或更高版本 |
安装
在桌面应用中安装
打开包窗口(状态栏中的包图标),选择浏览,搜索 aigd.model3d-triposg,然后点击添加到项目。
还没安装应用?免费下载 AI Game Dev,支持 Windows、macOS 和 Linux。
从终端安装
在项目文件夹中使用 gamedev CLI:
gamedev pkg add aigd.model3d-triposg环境要求
- AI Game Dev 0.32.0-beta.6 或更高版本
- NVIDIA GPU,8 GB 显存或以上
gamedev pkg add aigd.model3d-triposg