Hunyuan3D-2.1 Shape(ローカル3Dモデル)
gamedev pkg add aigd.model3d-hunyuan3d-2-1-shape概要
ローカル画像→3D:Tencent Hunyuan3D-2.1のシェイプモデルが、1枚の画像から高品質なテクスチャなしの3Dメッシュ(GLB)を生成します。ゲームのプロップやキャラクター向けで、VRAM 10 GB以上のNVIDIA GPUで動作します。Local Python models runtimeでオフライン実行できます。EU、英国、韓国ではライセンスされていません。
Hunyuan3D-2.1 Shapeは、TencentによるHunyuan3D-2.1のシェイプモデルを使い、1枚の画像からNVIDIA GPU(VRAM 10 GB以上)上で高品質な3D形状を生成します。結果はテクスチャなしのGLBメッシュです。AI Game Devでは、Local Python models runtime(aigd.python)を通じてローカルで動作します。プロップやキャラクターの詳細なベースメッシュを必要とし、テクスチャリングは別のツールで行いたい開発者に適しています。欧州連合、英国、韓国ではライセンスされていません。
作成できるもの
- プロップ、武器、家具、クリーチャー、キャラクターのテクスチャなし3Dメッシュを、1枚のコンセプト画像から生成できます。
- 後で自分のツールや他のパッケージでテクスチャを貼ったり、リトポロジーやリギングを行ったりするためのベースメッシュです。
- コンセプトアートから素早く作る3Dブロックアウトです。
リクエスト例
- 「
Concepts/treasure_chest.pngをHunyuan3Dで3Dモデルにしてください。」 - 「この剣の画像(背景透過)から3D形状を作ってください。」
- 「今追加したキャラクターコンセプトのメッシュを生成してください。」
ハイライト
| モデルID | aigd.model3d-hunyuan3d-2-1-shape.v1 |
| 操作 | 画像→3D(入力画像1枚) |
| 出力 | テクスチャなしGLB |
| ステップ数 | デフォルトで50 |
| 動作環境 | NVIDIA GPU(CUDA)、VRAM 10 GB以上 |
| ダウンロード | 約7.4 GB、加えて初回読み込み時のランタイムのPython環境 |
| ライセンス | Tencent Hunyuan 3D 2.1 Community License:EU、英国、韓国では利用できません。月間アクティブユーザーが100万人を超える場合は別途ライセンスが必要です |
その他のローカル画像→3Dモデル
- TripoSG 1.5B:テクスチャなし、VRAM 8 GB。
- Step1X-3D Geometry:テクスチャなし、VRAM 16 GB、Apache-2.0。
- TRELLIS.2 4BとPixal3D:PBRマテリアル付きのテクスチャ付きGLB、NVIDIAまたはVulkan GPUで16 GB。
実行方法
Hunyuan3D-2.1のPBRテクスチャモデルは含まれていません。 これには、お使いのコンピューター上でコンパイルするカスタムCUDAラスタライザーと、PythonモジュールとしてのBlenderが必要で、アプリのランタイムではこれを行いません。背景が透明な、1つのオブジェクトだけが写った画像を使用してください。チェックポイントはPyTorchファイルで、テンソルとしてのみ読み込まれ(weights_only=True)、コードとして実行されることはありません。
出力には小さな分離パーツが含まれることがあります。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.4 GB。Hugging Faceのリビジョンとsha256で固定されています:
| ファイル | サイズ | ライセンス | ソース |
|---|---|---|---|
hunyuan3d-dit-v2-1-config.yaml | 0.00 GB | Tencent Hunyuan 3D 2.1 Community License | ファイル |
hunyuan3d-dit-v2-1-model.fp16.ckpt | 7.37 GB | Tencent Hunyuan 3D 2.1 Community License | ファイル |
モデルのPythonコードは、固定されたコミットのGitHubからダウンロードされ、各ファイルはsha256で検証されます。
ライセンス
hy3dshapeのファイルヘッダーには「非商用(non-commercial)」ライセンスへの言及がありますが、リポジトリのLICENSE(上記)はCommunity Licenseであり、こちらが適用されます。
必要な帰属表示(Notice):"Tencent Hunyuan 3D 2.1 is licensed under the Tencent Hunyuan 3D 2.1 Community License Agreement, Copyright © 2025 Tencent. All Rights Reserved. The trademark rights of "Tencent Hunyuan" are owned by Tencent or its affiliate."
制限事項:
- 欧州連合、英国、韓国ではライセンスされていません。 これらの地域でモデルやその出力を使用することはできません。
- 月間アクティブユーザーが100万人を超える製品やサービスには、Tencentとの別途ライセンスが必要です。
- モデルとその出力を、他のAIモデルの改善に使用することはできません。
- TencentのAcceptable Use Policyが適用されます。
自身の利用が許可されているかどうかを確認するのは、あなたの責任です。
バージョン
| バージョン | リリース日 | アプリが必要 |
|---|---|---|
| 1.0.3最新 | 0.32.0-beta.6 以降 | |
| 1.0.2 | 0.32.0-beta.6 以降 |
インストール
デスクトップアプリで
Packages ウィンドウを開き(ステータスバーのパッケージアイコン)、Browse を選んで aigd.model3d-hunyuan3d-2-1-shape を検索し、Add to Project をクリックします。
アプリがまだない方は、Windows、macOS、Linux 用の AI Game Dev を無料でダウンロードしてください。
ターミナルから
gamedev CLI を使い、プロジェクトフォルダーで実行します。
gamedev pkg add aigd.model3d-hunyuan3d-2-1-shape必要条件
- AI Game Dev 0.32.0-beta.6 以降
- 10 GB以上のNVIDIA GPU
gamedev pkg add aigd.model3d-hunyuan3d-2-1-shape