# Hunyuan3D-2.1 Shape（ローカル3Dモデル）

> ローカル画像→3D：Tencent Hunyuan3D-2.1のシェイプモデルが、1枚の画像から高品質なテクスチャなしの3Dメッシュ（GLB）を生成します。ゲームのプロップやキャラクター向けで、VRAM 10 GB以上のNVIDIA GPUで動作します。Local Python models runtimeでオフライン実行できます。EU、英国、韓国ではライセンスされていません。

- ID: `aigd.model3d-hunyuan3d-2-1-shape`
- ソース: 公式 (ファーストパーティ `aigd.*`)
- カテゴリ: 3D
- パブリッシャー: AI Game Dev (`aigd`), 確認済み
- 最新バージョン: 1.0.3 (公開日 2026-11-22)
- ライセンス: SEE LICENSE IN README.md
- AI Game Dev アプリが必要です: `>=0.32.0-beta.6`
- ネイティブコード: いいえ
- 評価: まだ評価はありません
- HTML ページ: https://ai-game.dev/ja/packages/aigd.model3d-hunyuan3d-2-1-shape

## インストール

gamedev CLI を使用する場合は、プロジェクトフォルダで:

```bash
gamedev pkg add aigd.model3d-hunyuan3d-2-1-shape
```

デスクトップアプリで: パッケージウィンドウ（ステータスバーのパッケージアイコン）を開き、**参照** を選択して `aigd.model3d-hunyuan3d-2-1-shape` を検索し、**プロジェクトに追加** をクリックします。詳細: https://ai-game.dev/docs/wiki/app/packages

## バージョン

| バージョン | 公開日 | アプリが必要 | 備考 |
|---|---|---|---|
| 1.0.3 | 2026-11-22 | `>=0.32.0-beta.6` | 最新 |
| 1.0.2 | 2026-11-21 | `>=0.32.0-beta.6` | - |

## 説明

````markdown
# Hunyuan3D-2.1 Shape (`aigd.model3d-hunyuan3d-2-1-shape`)

Hunyuan3D-2.1 Shapeは、Tencentによる[Hunyuan3D-2.1](https://github.com/Tencent-Hunyuan/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](https://ai-game.dev/packages/aigd.model3d-triposg)：テクスチャなし、VRAM 8 GB。
- [Step1X-3D Geometry](https://ai-game.dev/packages/aigd.model3d-step1x-3d-geometry)：テクスチャなし、VRAM 16 GB、Apache-2.0。
- [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。

## 実行方法

**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 | [ファイル](https://huggingface.co/tencent/Hunyuan3D-2.1/resolve/0b94677654c57bb9a6b6845cd7b704ccf551d327/hunyuan3d-dit-v2-1/config.yaml) |
| `hunyuan3d-dit-v2-1-model.fp16.ckpt` | 7.37 GB | Tencent Hunyuan 3D 2.1 Community License | [ファイル](https://huggingface.co/tencent/Hunyuan3D-2.1/resolve/0b94677654c57bb9a6b6845cd7b704ccf551d327/hunyuan3d-dit-v2-1/model.fp16.ckpt) |

モデルのPythonコードは、固定されたコミットのGitHubからダウンロードされ、各ファイルはsha256で検証されます。

## ライセンス

- **重みと推論コード：Tencent Hunyuan 3D 2.1 Community License**（[ライセンス](https://huggingface.co/tencent/Hunyuan3D-2.1/blob/0b94677654c57bb9a6b6845cd7b704ccf551d327/LICENSE)、[モデルカード](https://huggingface.co/tencent/Hunyuan3D-2.1/tree/0b94677654c57bb9a6b6845cd7b704ccf551d327)、コード`hy3dshape/`はGitHubのコミット[`82920d6`](https://github.com/Tencent-Hunyuan/Hunyuan3D-2.1/tree/82920d643c0dc2f7bfd7255f45f62d386edfe60c)より）。

`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が適用されます。

自身の利用が許可されているかどうかを確認するのは、あなたの責任です。
````
