# Step1X-3D Geometry（本地 3D 模型）

> 本地图像转 3D：StepFun 的 Step1X-3D Geometry 1.3B 可在你的 NVIDIA GPU 上（16 GB 显存）把一张图像变成无贴图的 3D 网格（GLB），用于游戏道具和角色。在 Local Python models runtime 中离线运行。Apache-2.0，允许商业使用。

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

## 安装

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

```bash
gamedev pkg add aigd.model3d-step1x-3d-geometry
```

在桌面应用中：打开 Packages 窗口（状态栏中的包图标），选择 **Browse**，搜索 `aigd.model3d-step1x-3d-geometry`，然后点击 **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
# Step1X-3D Geometry 1.3B (`aigd.model3d-step1x-3d-geometry`)

Step1X-3D Geometry 1.3B 使用 StepFun 的 [Step1X-3D](https://github.com/stepfun-ai/Step1X-3D) 几何模型，在你的 NVIDIA GPU 上（16 GB 或以上显存）把一张图像转成 3D 形状。结果是未贴图的 GLB。在 AI Game Dev 中，它通过 **Local Python models runtime**（`aigd.python`）在本地运行。其权重和代码为 Apache-2.0，没有地域限制，也没有用户数量上限，因此适用于任何地区的商业游戏。

## 你可以做什么

- 从一张图像生成道具、建筑、载具、生物和角色的无贴图网格。
- 可供后续贴图、重拓扑或绑定骨骼的基础网格。
- 根据概念图制作 3D 粗模。

## 示例请求

- “用 Step1X-3D 把 `Concepts/barrel.png` 变成 3D 模型。”
- “给这条龙的概念图做一个网格模型。”
- “生成这张房屋图像的 3D 形状。”

## 亮点

|  |  |
|---|---|
| 模型 id | `aigd.model3d-step1x-3d-geometry.v1` |
| 操作 | 图像转 3D（一张背景透明的输入图像） |
| 输出 | 未贴图的 GLB，面数默认精简到 200,000 |
| 步数 | 默认 50 |
| 运行于 | NVIDIA GPU（CUDA），16 GB 或以上显存 |
| 下载 | 约 7.2 GB，首次加载时还需下载运行时的 Python 环境 |
| 许可证 | Apache-2.0，允许商业使用 |

## 其他本地图像转 3D 模型

- [TripoSG 1.5B](https://ai-game.dev/packages/aigd.model3d-triposg)：未贴图，8 GB 显存。
- [Hunyuan3D-2.1 Shape](https://ai-game.dev/packages/aigd.model3d-hunyuan3d-2-1-shape)：未贴图，10 GB 显存。
- [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 显存。

## 运行方式

**不包含 Step1X-3D 的贴图模型。** 它需要 `nvdiffrast`（NVIDIA Source Code License，非商业）和 `pytorch3d`（没有预编译包），因此无法在应用的运行时中运行。请使用一张只有一个物体、背景透明的图像：应用会将其裁剪到该物体。面数默认精简到 200,000。

输出结果可能包含小的分离部件：在针对 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.2 GB，通过 Hugging Face 修订版本和 sha256 固定：

| 文件 | 大小 | 许可证 | 来源 |
|---|---|---|---|
| `model_index.json` | 0.00 GB | Apache-2.0 | [文件](https://huggingface.co/stepfun-ai/Step1X-3D/resolve/bf7084495b3a72222f36549b7942948aa4d9daa7/Step1X-3D-Geometry-1300m/model_index.json) |
| `scheduler-scheduler_config.json` | 0.00 GB | Apache-2.0 | [文件](https://huggingface.co/stepfun-ai/Step1X-3D/resolve/bf7084495b3a72222f36549b7942948aa4d9daa7/Step1X-3D-Geometry-1300m/scheduler/scheduler_config.json) |
| `transformer-config.json` | 0.00 GB | Apache-2.0 | [文件](https://huggingface.co/stepfun-ai/Step1X-3D/resolve/bf7084495b3a72222f36549b7942948aa4d9daa7/Step1X-3D-Geometry-1300m/transformer/config.json) |
| `transformer-diffusion_pytorch_model.safetensors` | 5.27 GB | Apache-2.0 | [文件](https://huggingface.co/stepfun-ai/Step1X-3D/resolve/bf7084495b3a72222f36549b7942948aa4d9daa7/Step1X-3D-Geometry-1300m/transformer/diffusion_pytorch_model.safetensors) |
| `vae-config.json` | 0.00 GB | Apache-2.0 | [文件](https://huggingface.co/stepfun-ai/Step1X-3D/resolve/bf7084495b3a72222f36549b7942948aa4d9daa7/Step1X-3D-Geometry-1300m/vae/config.json) |
| `vae-diffusion_pytorch_model.safetensors` | 0.77 GB | Apache-2.0 | [文件](https://huggingface.co/stepfun-ai/Step1X-3D/resolve/bf7084495b3a72222f36549b7942948aa4d9daa7/Step1X-3D-Geometry-1300m/vae/diffusion_pytorch_model.safetensors) |
| `visual_eature_extractor-preprocessor_config.json` | 0.00 GB | Apache-2.0 | [文件](https://huggingface.co/stepfun-ai/Step1X-3D/resolve/bf7084495b3a72222f36549b7942948aa4d9daa7/Step1X-3D-Geometry-1300m/visual_eature_extractor/preprocessor_config.json) |
| `visual_encoder-config.json` | 0.00 GB | Apache-2.0 | [文件](https://huggingface.co/stepfun-ai/Step1X-3D/resolve/bf7084495b3a72222f36549b7942948aa4d9daa7/Step1X-3D-Geometry-1300m/visual_encoder/config.json) |
| `visual_encoder-diffusion_pytorch_model.safetensors` | 1.22 GB | Apache-2.0 | [文件](https://huggingface.co/stepfun-ai/Step1X-3D/resolve/bf7084495b3a72222f36549b7942948aa4d9daa7/Step1X-3D-Geometry-1300m/visual_encoder/diffusion_pytorch_model.safetensors) |
| `dinov2-with-registers-large-config.json` | 0.00 GB | Apache-2.0 | [文件](https://huggingface.co/facebook/dinov2-with-registers-large/resolve/e4c89a4e05589de9b3e188688a303d0f3c04d0f3/config.json) |
| `dinov2-with-registers-large-preprocessor_config.json` | 0.00 GB | Apache-2.0 | [文件](https://huggingface.co/facebook/dinov2-with-registers-large/resolve/e4c89a4e05589de9b3e188688a303d0f3c04d0f3/preprocessor_config.json) |

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

## 许可证

- **权重：Apache-2.0**，© StepFun（[模型卡](https://huggingface.co/stepfun-ai/Step1X-3D/tree/bf7084495b3a72222f36549b7942948aa4d9daa7)）。
- **推理代码**（`step1x3d_geometry/`，来自 GitHub，提交 [`cb5ac94`](https://github.com/stepfun-ai/Step1X-3D/tree/cb5ac944709c6c913109070c7b90c3447f57f3d4)）：Apache-2.0（[许可证](https://github.com/stepfun-ai/Step1X-3D/blob/cb5ac944709c6c913109070c7b90c3447f57f3d4/LICENSE)）。
- **带 registers 的 DINOv2（large）配置文件**：Apache-2.0，© Meta Platforms（[模型卡](https://huggingface.co/facebook/dinov2-with-registers-large/tree/e4c89a4e05589de9b3e188688a303d0f3c04d0f3)）。只下载其中的 `config.json` 和 `preprocessor_config.json`；编码器权重属于 Step1X-3D。

需要署名："Step1X-3D © StepFun (Apache-2.0)"。

**限制：**允许商业使用。再分发权重时需要附带 Apache-2.0 许可证文本和 StepFun 的声明。
````
