# Step1X-3D Geometry（ローカル3Dモデル）

> ローカル画像→3D: StepFunのStep1X-3D Geometry 1.3Bは、1枚の画像からテクスチャなしの3Dメッシュ（GLB）を生成し、ゲームの小道具やキャラクターに使えます。NVIDIA GPU（VRAM 16 GB）で動作します。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/ja/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)のジオメトリモデルを使い、1枚の画像からNVIDIA GPU（VRAM 16 GB以上）上で3D形状を生成します。結果はテクスチャなしのGLBです。AI Game Devでは、**Local Python models runtime**（`aigd.python`）を通じてローカルで動作します。重みとコードはApache-2.0で、地域制限もユーザー数上限もないため、世界中の商用ゲームに適しています。

## 何が作れるか

- 1枚の画像から、小道具、建物、乗り物、クリーチャー、キャラクターのテクスチャなしメッシュを作成できます。
- 後からテクスチャを貼ったり、リトポロジーやリグ付けを行うためのベースメッシュ。
- コンセプトアートから3Dのブロックアウトを作成できます。

## リクエスト例

- 「`Concepts/barrel.png`をStep1X-3Dで3Dモデルに変換して」
- 「ドラゴンのコンセプトのメッシュを作って」
- 「この家の画像の3D形状を生成して」

## ハイライト

|  |  |
|---|---|
| モデルID | `aigd.model3d-step1x-3d-geometry.v1` |
| 動作 | 画像から3D（背景が透明な入力画像1枚） |
| 出力 | テクスチャなしのGLB、面数はデフォルトで200,000に削減 |
| ステップ数 | デフォルトで50 |
| 動作環境 | NVIDIA GPU（CUDA）、VRAM 16 GB以上 |
| ダウンロード | 約7.2 GB、加えて初回読み込み時のランタイムのPython環境 |
| ライセンス | Apache-2.0、商用利用可能 |

## その他のローカル画像→3Dモデル

- [TripoSG 1.5B](https://ai-game.dev/packages/aigd.model3d-triposg): テクスチャなし、VRAM 8 GB。
- [Hunyuan3D-2.1 Shape](https://ai-game.dev/packages/aigd.model3d-hunyuan3d-2-1-shape): テクスチャなし、VRAM 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`（ビルド済みパッケージなし）が必要なため、アプリのランタイムでは実行できません。背景が透明で、オブジェクトが1つだけ写った画像を使用してください。アプリがそのオブジェクトに合わせて切り抜きます。面数はデフォルトで200,000に削減されます。

出力には小さく分離したパーツが含まれることがあります。TripoSG、Step1X-3D、Hunyuan3DのGPU検証では、主要なコンポーネントが面全体の97.5～99.2%を占めていました。

このパッケージはデータのみです。**Local Python models runtime**（`aigd.python`）が必要で、これは初回読み込み時にモデル用のプライベートなPython環境を構築します（PyTorchと各種ライブラリで数GB。詳しくはそのパッケージの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)）。
- **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の通知が必要です。
````
