Step1X-3D Geometry(本地 3D 模型)
gamedev pkg add aigd.model3d-step1x-3d-geometry概览
本地图像转 3D:StepFun 的 Step1X-3D Geometry 1.3B 可在你的 NVIDIA GPU 上(16 GB 显存)把一张图像变成无贴图的 3D 网格(GLB),用于游戏道具和角色。在 Local Python models runtime 中离线运行。Apache-2.0,允许商业使用。
Step1X-3D Geometry 1.3B 使用 StepFun 的 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:未贴图,8 GB 显存。
- Hunyuan3D-2.1 Shape:未贴图,10 GB 显存。
- TRELLIS.2 4B 与 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 | 文件 |
scheduler-scheduler_config.json | 0.00 GB | Apache-2.0 | 文件 |
transformer-config.json | 0.00 GB | Apache-2.0 | 文件 |
transformer-diffusion_pytorch_model.safetensors | 5.27 GB | Apache-2.0 | 文件 |
vae-config.json | 0.00 GB | Apache-2.0 | 文件 |
vae-diffusion_pytorch_model.safetensors | 0.77 GB | Apache-2.0 | 文件 |
visual_eature_extractor-preprocessor_config.json | 0.00 GB | Apache-2.0 | 文件 |
visual_encoder-config.json | 0.00 GB | Apache-2.0 | 文件 |
visual_encoder-diffusion_pytorch_model.safetensors | 1.22 GB | Apache-2.0 | 文件 |
dinov2-with-registers-large-config.json | 0.00 GB | Apache-2.0 | 文件 |
dinov2-with-registers-large-preprocessor_config.json | 0.00 GB | Apache-2.0 | 文件 |
模型的 Python 代码从 GitHub 按固定的提交下载,每个文件都通过 sha256 校验。
许可证
- 权重:Apache-2.0,© StepFun(模型卡)。
- 推理代码(
step1x3d_geometry/,来自 GitHub,提交cb5ac94):Apache-2.0(许可证)。 - 带 registers 的 DINOv2(large)配置文件:Apache-2.0,© Meta Platforms(模型卡)。只下载其中的
config.json和preprocessor_config.json;编码器权重属于 Step1X-3D。
需要署名:"Step1X-3D © StepFun (Apache-2.0)"。
限制:允许商业使用。再分发权重时需要附带 Apache-2.0 许可证文本和 StepFun 的声明。
版本
| 版本 | 发布时间 | 需要应用 |
|---|---|---|
| 1.0.4最新 | 0.32.0-beta.6 或更高版本 | |
| 1.0.3 | 0.32.0-beta.6 或更高版本 |
安装
在桌面应用中安装
打开包窗口(状态栏中的包图标),选择浏览,搜索 aigd.model3d-step1x-3d-geometry,然后点击添加到项目。
还没安装应用?免费下载 AI Game Dev,支持 Windows、macOS 和 Linux。
从终端安装
在项目文件夹中使用 gamedev CLI:
gamedev pkg add aigd.model3d-step1x-3d-geometry环境要求
- AI Game Dev 0.32.0-beta.6 或更高版本
- NVIDIA GPU,16 GB 显存或以上
gamedev pkg add aigd.model3d-step1x-3d-geometry