Step1X-3D Geometry(ローカル3Dモデル)
gamedev pkg add aigd.model3d-step1x-3d-geometry概要
ローカル画像→3D: StepFunのStep1X-3D Geometry 1.3Bは、1枚の画像からテクスチャなしの3Dメッシュ(GLB)を生成し、ゲームの小道具やキャラクターに使えます。NVIDIA GPU(VRAM 16 GB)で動作します。Local Python models runtimeでオフライン実行できます。Apache-2.0、商用利用可能。
Step1X-3D Geometry 1.3Bは、StepFunによる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: テクスチャなし、VRAM 8 GB。
- Hunyuan3D-2.1 Shape: テクスチャなし、VRAM 10 GB。
- TRELLIS.2 4Bと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 | ファイル |
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 以降 |
インストール
デスクトップアプリで
Packages ウィンドウを開き(ステータスバーのパッケージアイコン)、Browse を選んで aigd.model3d-step1x-3d-geometry を検索し、Add to Project をクリックします。
アプリがまだない方は、Windows、macOS、Linux 用の AI Game Dev を無料でダウンロードしてください。
ターミナルから
gamedev CLI を使い、プロジェクトフォルダーで実行します。
gamedev pkg add aigd.model3d-step1x-3d-geometry必要条件
- AI Game Dev 0.32.0-beta.6 以降
- 16 GB以上のNVIDIA GPU
gamedev pkg add aigd.model3d-step1x-3d-geometry