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

> 本機影像轉 3D：StepFun 的 Step1X-3D Geometry 1.3B 能把一張影像變成未貼圖的 3D 網格（GLB），適合遊戲道具與角色，在你的 NVIDIA GPU 上以 16 GB VRAM 執行。在 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-hant/packages/aigd.model3d-step1x-3d-geometry

## 安裝

在專案資料夾中，使用 gamedev CLI：

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

在桌面應用程式中：開啟「套件」視窗（狀態列上的套件圖示），選擇 **瀏覽**，搜尋 `aigd.model3d-step1x-3d-geometry`，然後點 **加入專案**。更多資訊：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 以上 VRAM）上把一張影像變成 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 以上 VRAM |
| 下載 | 約 7.2 GB，首次載入時另會建立執行環境的 Python 環境 |
| 授權 | Apache-2.0，允許商業使用 |

## 其他本機影像轉 3D 模型

- [TripoSG 1.5B](https://ai-game.dev/packages/aigd.model3d-triposg)：未貼圖，8 GB VRAM。
- [Hunyuan3D-2.1 Shape](https://ai-game.dev/packages/aigd.model3d-hunyuan3d-2-1-shape)：未貼圖，10 GB VRAM。
- [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 revision 與 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)）。
- **DINOv2 with registers（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 的聲明。
````
