Step1X-3D Geometry(本機 3D 模型)
gamedev pkg add aigd.model3d-step1x-3d-geometry總覽
本機影像轉 3D:StepFun 的 Step1X-3D Geometry 1.3B 能把一張影像變成未貼圖的 3D 網格(GLB),適合遊戲道具與角色,在你的 NVIDIA GPU 上以 16 GB VRAM 執行。在 Local Python models runtime 中離線運作。Apache-2.0,允許商業使用。
Step1X-3D Geometry 1.3B 會用 StepFun 的 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:未貼圖,8 GB VRAM。
- Hunyuan3D-2.1 Shape:未貼圖,10 GB VRAM。
- 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 revision 與 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(授權條款)。 - DINOv2 with registers(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