# TripoSG 1.5B（本地 3D 模型）

> 本地图生 3D：VAST-AI 的 TripoSG 1.5B 可将一张图像变成细节丰富、表面锐利干净的无纹理 3D 网格（GLB），在你的 NVIDIA GPU 上运行，需 8 GB 显存。在 Local Python models runtime 中可离线运行。权重为 MIT；其推理代码中的部分 Tencent 代码在欧盟、英国和韩国未获许可。

- ID: `aigd.model3d-triposg`
- 来源: 官方 (第一方 `aigd.*`)
- 分类: 3D
- 发布者: AI Game Dev (`aigd`), 已验证
- 最新版本: 1.0.4 (发布于 2026-11-22)
- 许可证: SEE LICENSE IN README.md
- 需要 AI Game Dev 应用: `>=0.32.0-beta.6`
- 原生代码: 否
- 评分: 暂无评分
- HTML 页面: https://ai-game.dev/zh-hans/packages/aigd.model3d-triposg

## 安装

使用 gamedev CLI，在项目文件夹中运行：

```bash
gamedev pkg add aigd.model3d-triposg
```

在桌面应用中：打开 Packages 窗口（状态栏中的包图标），选择 **Browse**，搜索 `aigd.model3d-triposg`，然后点击 **Add to Project**。更多：https://ai-game.dev/docs/wiki/app/packages

## 版本

| 版本 | 发布时间 | 需要应用 | 备注 |
|---|---|---|---|
| 1.0.4 | 2026-11-22 | `>=0.32.0-beta.6` | 最新 |
| 1.0.3 | 2026-11-21 | `>=0.32.0-beta.6` | - |

## 描述

````markdown
# TripoSG 1.5B (`aigd.model3d-triposg`)

TripoSG 1.5B 借助 VAST-AI 的 [TripoSG](https://github.com/VAST-AI-Research/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](https://ai-game.dev/packages/aigd.model3d-hunyuan3d-2-1-shape)：无纹理，10 GB 显存。
- [Step1X-3D Geometry](https://ai-game.dev/packages/aigd.model3d-step1x-3d-geometry)：无纹理，16 GB 显存，Apache-2.0，无地域限制。
- [TRELLIS.2 4B](https://ai-game.dev/packages/aigd.model3d-trellis2-4b) 和 [Pixal3D](https://ai-game.dev/packages/aigd.model3d-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 | [文件](https://huggingface.co/VAST-AI/TripoSG/resolve/2c1c516d22d58db486a058d98d31bb6177344e06/feature_extractor_dinov2/preprocessor_config.json) |
| `image_encoder_dinov2-config.json` | 0.00 GB | MIT | [文件](https://huggingface.co/VAST-AI/TripoSG/resolve/2c1c516d22d58db486a058d98d31bb6177344e06/image_encoder_dinov2/config.json) |
| `image_encoder_dinov2-model.safetensors` | 1.22 GB | MIT | [文件](https://huggingface.co/VAST-AI/TripoSG/resolve/2c1c516d22d58db486a058d98d31bb6177344e06/image_encoder_dinov2/model.safetensors) |
| `model_index.json` | 0.00 GB | MIT | [文件](https://huggingface.co/VAST-AI/TripoSG/resolve/2c1c516d22d58db486a058d98d31bb6177344e06/model_index.json) |
| `scheduler-scheduler_config.json` | 0.00 GB | MIT | [文件](https://huggingface.co/VAST-AI/TripoSG/resolve/2c1c516d22d58db486a058d98d31bb6177344e06/scheduler/scheduler_config.json) |
| `transformer-config.json` | 0.00 GB | MIT | [文件](https://huggingface.co/VAST-AI/TripoSG/resolve/2c1c516d22d58db486a058d98d31bb6177344e06/transformer/config.json) |
| `transformer-diffusion_pytorch_model.safetensors` | 5.76 GB | MIT | [文件](https://huggingface.co/VAST-AI/TripoSG/resolve/2c1c516d22d58db486a058d98d31bb6177344e06/transformer/diffusion_pytorch_model.safetensors) |
| `vae-config.json` | 0.00 GB | MIT | [文件](https://huggingface.co/VAST-AI/TripoSG/resolve/2c1c516d22d58db486a058d98d31bb6177344e06/vae/config.json) |
| `vae-diffusion_pytorch_model.safetensors` | 0.97 GB | MIT | [文件](https://huggingface.co/VAST-AI/TripoSG/resolve/2c1c516d22d58db486a058d98d31bb6177344e06/vae/diffusion_pytorch_model.safetensors) |

模型的 Python 代码从 GitHub 按固定提交下载，每个文件都经 sha256 校验。

## 许可

- **权重：MIT**，© 2025 VAST-AI-Research 及贡献者（[模型卡](https://huggingface.co/VAST-AI/TripoSG/tree/2c1c516d22d58db486a058d98d31bb6177344e06)）。
- **推理代码**（`triposg/`，从 GitHub 按提交 [`fc5c409`](https://github.com/VAST-AI-Research/TripoSG/tree/fc5c40990181e2a756c4e0b1c2f4d6b5202faf8c) 下载）：仓库本身为 MIT，但其 `triposg/` 文件夹带有 [Tencent Hunyuan FlashVDM Community License](https://github.com/VAST-AI-Research/TripoSG/blob/fc5c40990181e2a756c4e0b1c2f4d6b5202faf8c/triposg/LICENSE)，其 [NOTICE](https://github.com/VAST-AI-Research/TripoSG/blob/fc5c40990181e2a756c4e0b1c2f4d6b5202faf8c/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 的可接受使用政策。

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