> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-mintlify-b90d3c69.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# ComfyUI Hunyuan3D-2 例

> このガイドでは、ComfyUI で Hunyuan3D-2 を使用して 3D アセットを生成する方法を説明します。

# Hunyuan3D 2.0 はじめに

![Hunyuan 3D 2](https://raw.githubusercontent.com/Tencent/Hunyuan3D-2/main/assets/images/e2e-1.gif)
![Hunyuan 3D 2](https://raw.githubusercontent.com/Tencent/Hunyuan3D-2/main/assets/images/e2e-2.gif)
[Hunyuan3D 2.0](https://github.com/Tencent/Hunyuan3D-2) は、テンセントがリリースしたオープンソースの 3D アセット生成モデルで、テキストまたは画像を通じて高忠実度の 3D モデルと高解像度のテクスチャマップを生成できます。

Hunyuan3D 2.0 は 2 段階の生成アプローチを採用しており、まずテクスチャのない幾何形状モデルを生成し、その後高解像度のテクスチャマップを合成します。これにより、形状とテクスチャの生成の複雑さを効果的に分離しています。以下は Hunyuan3D 2.0 の 2 つのコアコンポーネントです：

1. **幾何形状生成モデル（Hunyuan3D-DiT）**：フロー拡散 Transformer アーキテクチャに基づき、入力条件に正確に一致するテクスチャのない幾何形状モデルを生成します。
2. **テクスチャ生成モデル（Hunyuan3D-Paint）**：幾何条件とマルチビュー拡散技術を組み合わせて、モデルに高解像度のテクスチャを追加し、PBR マテリアルをサポートします。

**主な利点**

* **高精度生成**：鋭い幾何構造、豊かなテクスチャカラー、PBR マテリアル生成のサポートにより、ほぼ現実的な照明効果を実現。
* **多様な使用方法**：コード呼び出し、Blender プラグイン、Gradio アプリケーション、および公式サイトを通じたオンライン体験を提供し、異なるユーザーニーズに対応。
* **軽量性と互換性**：Hunyuan3D-2mini モデルは VRAM 5GB のみ必要、標準バージョンの形状生成には VRAM 6GB、完全なプロセス（形状 + テクスチャ）には VRAM 12GB のみ必要。

最近（2025 年 3 月 18 日）、Hunyuan3D 2.0 はマルチビュー形状生成モデル（Hunyuan3D-2mv）も導入し、異なる角度からの入力からより詳細な幾何構造を生成できるようになりました。

この例には 3 つのワークフローが含まれています：

* Hunyuan3D-2mv を使用して複数のビュー入力から 3D モデルを生成
* Hunyuan3D-2mv-turbo を使用して複数のビュー入力から 3D モデルを生成
* Hunyuan3D-2 を使用して単一のビュー入力から 3D モデルを生成

<Tip>
  ComfyUI は現在 Hunyuan3D-2mv をネイティブサポートしていますが、テクスチャとマテリアルの生成はまだサポートしていません。開始する前に、最新バージョンの [ComfyUI](https://github.com/Comfy-Org/ComfyUI) にアップデートされていることを確認してください。

  このチュートリアルのワークフロー例 PNG 画像には、メタデータにワークフロー JSON が含まれています：

  * ComfyUI に直接ドラッグできます
  * またはメニュー `Workflows` -> `Open (ctrl+o)` を使用できます

  これにより、対応するワークフローが読み込まれ、必要なモデルのダウンロードを促されます。生成された `.glb` 形式のモデルは `ComfyUI/output/mesh` フォルダに出力されます。
</Tip>

## ComfyUI Hunyuan3D-2mv ワークフロー例

Hunyuan3D-2mv ワークフローでは、マルチビュー画像を使用して 3D モデルを生成します。このワークフローでは複数のビュー画像は必須ではありません - `front` ビュー画像のみを使用して 3D モデルを生成できます。

<Tip>
  <Tabs>
    <Tab title="ポータブル版または自宅サーバーで実行しているユーザー">
      ComfyUI が最新版に更新されていることを確認してください。

      * [ComfyUI のダウンロード](https://www.comfy.org/download)
      * [更新手順](/ja/installation/update_comfyui)

      このガイドで紹介するワークフローは、[ワークフローテンプレート](/ja/interface/features/template)から入手できます。\
      テンプレート内に該当のワークフローが見つからない場合、ComfyUI のバージョンが古くなっている可能性があります。（デスクトップ版の更新は若干遅れることがあります）

      ワークフローを読み込んだ際にノードが欠落している場合の主な原因：

      1. 最新の ComfyUI（Nightly 版）を使用していない
      2. 起動時に一部のノードのインポートに失敗している
    </Tab>

    <Tab title="デスクトップ版またはクラウド版ユーザー">
      * デスクトップ版は ComfyUI の安定版（Stable Release）をベースとしており、新しいデスクトップ安定版がリリースされると自動的に更新されます。
      * [Cloud](https://cloud.comfy.org) は、ComfyUI の安定版リリース後に更新されます。

      したがって、このドキュメントで記載されているコアノードのうち、一部が利用できない場合は、そのノード機能がまだ最新の安定版に含まれていないためです。次回の安定版リリースをお待ちください。
    </Tab>
  </Tabs>
</Tip>

<a className="prose" target="_blank" href="https://cloud.comfy.org/?template=3d_hunyuan3d_multiview_to_model&utm_source=docs" style={{ display: 'inline-block', backgroundColor: '#28A745', color: '#FFFFFF', padding: '10px 20px', borderRadius: '8px', borderColor: "transparent", textDecoration: 'none', fontWeight: 'bold'}}>
  <p className="prose" style={{ margin: 0, fontSize: "0.8rem" }}>Run on Comfy Cloud</p>
</a>

### 1. ワークフロー

以下の画像をダウンロードし、ComfyUI にドラッグしてワークフローを読み込んでください。
![Hunyuan3D-2mv workflow](https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/3d/hunyuan3d-2/hunyuan3d_2mv_elf/hunyuan-3d-multiview-elf.webp)

以下の画像をダウンロードしてください。これらを入力画像として使用します。

![input image](https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/3d/hunyuan3d-2/hunyuan3d_2mv_elf/front.png)
![input image](https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/3d/hunyuan3d-2/hunyuan3d_2mv_elf/left.png)
![input image](https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/3d/hunyuan3d-2/hunyuan3d_2mv_elf/back.png)

<Tip>
  この例では、入力画像はすでに余分な背景を除去するように前処理されています。実際の使用では、[ComfyUI\_essentials](https://github.com/cubiq/ComfyUI_essentials) のようなカスタムノードを使用して、余分な背景を自動的に除去できます。
</Tip>

### 2. 手動モデルインストール

以下のモデルをダウンロードし、対応する ComfyUI フォルダに保存してください

* hunyuan3d-dit-v2-mv: [model.fp16.safetensors](https://huggingface.co/tencent/Hunyuan3D-2mv/resolve/main/hunyuan3d-dit-v2-mv/model.fp16.safetensors?download=true) - ダウンロード後、`hunyuan3d-dit-v2-mv.safetensors` にリネームできます

```
ComfyUI/
├── models/
│   ├── checkpoints/
│   │   └── hunyuan3d-dit-v2-mv.safetensors  // リネーム後のファイル
```

### 3. ワークフローの実行手順

<img src="https://mintcdn.com/dripart-mintlify-b90d3c69/13fptzMgnetfPFwP/images/tutorial/3d/hunyuan3d-2mv/hunyuan3d_2mv.jpg?fit=max&auto=format&n=13fptzMgnetfPFwP&q=85&s=80e0efd5a6be2464104eb1194b2f3c36" alt="ComfyUI hunyuan3d_2mv" width="3000" height="1618" data-path="images/tutorial/3d/hunyuan3d-2mv/hunyuan3d_2mv.jpg" />

1. Image Only Checkpoint Loader(img2vid model) が、ダウンロードしてリネームした `hunyuan3d-dit-v2-mv.safetensors` モデルを読み込んでいることを確認します
2. 各 `Load Image` ノードに対応するビュー画像を読み込みます
3. `Queue` ボタンをクリックするか、ショートカット `Ctrl(cmd) + Enter` を使用してワークフローを実行します

より多くのビューを追加する必要がある場合は、`Hunyuan3Dv2ConditioningMultiView` ノードに他のビュー画像を読み込み、`Load Image` ノードに対応するビュー画像を読み込むことを確認してください。

## Hunyuan3D-2mv-turbo ワークフロー

Hunyuan3D-2mv-turbo ワークフローでは、Hunyuan3D-2mv-turbo モデルを使用して 3D モデルを生成します。このモデルは Hunyuan3D-2mv のステップ蒸留バージョンで、より高速な 3D モデル生成を可能にします。このバージョンのワークフローでは、`cfg` を 1.0 に設定し、`flux guidance` ノードを追加して `distilled cfg` 生成を制御します。

<a className="prose" target="_blank" href="https://cloud.comfy.org/?template=3d_hunyuan3d_multiview_to_model_turbo&utm_source=docs" style={{ display: 'inline-block', backgroundColor: '#28A745', color: '#FFFFFF', padding: '10px 20px', borderRadius: '8px', borderColor: "transparent", textDecoration: 'none', fontWeight: 'bold'}}>
  <p className="prose" style={{ margin: 0, fontSize: "0.8rem" }}>Run on Comfy Cloud</p>
</a>

### 1. ワークフロー

以下の画像をダウンロードし、ComfyUI にドラッグしてワークフローを読み込んでください。

![Hunyuan3D-2mv-turbo workflow](https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/3d/hunyuan3d-2/hunyuan3d_2mv_turbo/hunyuan-3d-turbo.webp)

以下の画像をダウンロードしてください。これらを入力画像として使用します。

![input image](https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/3d/hunyuan3d-2/hunyuan3d_2mv_turbo/front.png)
![input image](https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/3d/hunyuan3d-2/hunyuan3d_2mv_turbo/right.png)

### 2. 手動モデルインストール

以下のモデルをダウンロードし、対応する ComfyUI フォルダに保存してください

* hunyuan3d-dit-v2-mv-turbo: [model.fp16.safetensors](https://huggingface.co/tencent/Hunyuan3D-2mv/resolve/main/hunyuan3d-dit-v2-mv-turbo/model.fp16.safetensors?download=true) - ダウンロード後、`hunyuan3d-dit-v2-mv-turbo.safetensors` にリネームできます

```
ComfyUI/
├── models/
│   ├── checkpoints/
│   │   └── hunyuan3d-dit-v2-mv-turbo.safetensors  // リネーム後のファイル
```

### 3. ワークフローの実行手順

<img src="https://mintcdn.com/dripart-mintlify-b90d3c69/13fptzMgnetfPFwP/images/tutorial/3d/hunyuan3d-2mv/hunyuan3d_2mv_turbo.jpg?fit=max&auto=format&n=13fptzMgnetfPFwP&q=85&s=b4b9bdcbe3f4f5c36fbd172787275798" alt="ComfyUI hunyuan3d_2mv_turbo" width="3000" height="1621" data-path="images/tutorial/3d/hunyuan3d-2mv/hunyuan3d_2mv_turbo.jpg" />

1. `Image Only Checkpoint Loader(img2vid model)` ノードが、リネームした `hunyuan3d-dit-v2-mv-turbo.safetensors` モデルを読み込んでいることを確認します
2. 各 `Load Image` ノードに対応するビュー画像を読み込みます
3. `Queue` ボタンをクリックするか、ショートカット `Ctrl(cmd) + Enter` を使用してワークフローを実行します

## Hunyuan3D-2 単一ビューワークフロー

Hunyuan3D-2 ワークフローでは、Hunyuan3D-2 モデルを使用して 3D モデルを生成します。このモデルはマルチビューモデルではありません。このワークフローでは、`Hunyuan3Dv2ConditioningMultiView` ノードの代わりに `Hunyuan3Dv2Conditioning` ノードを使用します。

<a className="prose" target="_blank" href="https://cloud.comfy.org/?template=3d_hunyuan3d_image_to_model&utm_source=docs" style={{ display: 'inline-block', backgroundColor: '#28A745', color: '#FFFFFF', padding: '10px 20px', borderRadius: '8px', borderColor: "transparent", textDecoration: 'none', fontWeight: 'bold'}}>
  <p className="prose" style={{ margin: 0, fontSize: "0.8rem" }}>Run on Comfy Cloud</p>
</a>

### 1. ワークフロー

以下の画像をダウンロードし、ComfyUI にドラッグしてワークフローを読み込んでください。

![Hunyuan3D-2 workflow](https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/3d/hunyuan3d-2/hunyuan3d-non-multiview-train.webp)

以下の画像をダウンロードしてください。これを入力画像として使用します。
![ComfyUI Hunyuan 3D 2 workflow](https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/3d/hunyuan3d-2/hunyuan_3d_v2_non_multiview_train.png)

### 2. 手動モデルインストール

以下のモデルをダウンロードし、対応する ComfyUI フォルダに保存してください

* hunyuan3d-dit-v2-0: [model.fp16.safetensors](https://huggingface.co/tencent/Hunyuan3D-2/resolve/main/hunyuan3d-dit-v2-0/model.fp16.safetensors?download=true) - ダウンロード後、`hunyuan3d-dit-v2.safetensors` にリネームできます

```
ComfyUI/
├── models/
│   ├── checkpoints/
│   │   └── hunyuan3d-dit-v2.safetensors  // リネーム後のファイル
```

### 3. ワークフローの実行手順

<img src="https://mintcdn.com/dripart-mintlify-b90d3c69/13fptzMgnetfPFwP/images/tutorial/3d/hunyuan3d-2mv/hunyuan3d_2_non_multiview.jpg?fit=max&auto=format&n=13fptzMgnetfPFwP&q=85&s=aee9f1f368638953f97a484a9b487d25" alt="ComfyUI hunyuan3d_2" width="3000" height="1624" data-path="images/tutorial/3d/hunyuan3d-2mv/hunyuan3d_2_non_multiview.jpg" />

1. `Image Only Checkpoint Loader(img2vid model)` ノードが、リネームした `hunyuan3d-dit-v2.safetensors` モデルを読み込んでいることを確認します
2. `Load Image` ノードに画像を読み込みます
3. `Queue` ボタンをクリックするか、ショートカット `Ctrl(cmd) + Enter` を使用してワークフローを実行します

## コミュニティリソース

以下は Hunyuan3D-2 に関連する ComfyUI コミュニティリソースです

* [ComfyUI-Hunyuan3DWrapper](https://github.com/kijai/ComfyUI-Hunyuan3DWrapper)
* [Kijai/Hunyuan3D-2\_safetensors](https://huggingface.co/Kijai/Hunyuan3D-2_safetensors/tree/main)
* [ComfyUI-3D-Pack](https://github.com/MrForExample/ComfyUI-3D-Pack)

## Hunyuan3D 2.0 オープンソースモデルシリーズ

現在、Hunyuan3D 2.0 は完全な 3D 生成プロセスをカバーする複数のモデルをオープンソース化しています。詳細については [Hunyuan3D-2](https://github.com/Tencent/Hunyuan3D-2) をご覧ください。

**Hunyuan3D-2mini シリーズ**

| モデル                   | 説明             | 日付         | パラメータ | Huggingface                                                                          |
| --------------------- | -------------- | ---------- | ----- | ------------------------------------------------------------------------------------ |
| Hunyuan3D-DiT-v2-mini | Mini 画像から形状モデル | 2025-03-18 | 0.6B  | [訪問](https://huggingface.co/tencent/Hunyuan3D-2mini/tree/main/hunyuan3d-dit-v2-mini) |

**Hunyuan3D-2mv シリーズ**

| モデル                      | 説明                                             | 日付         | パラメータ | Huggingface                                                                           |
| ------------------------ | ---------------------------------------------- | ---------- | ----- | ------------------------------------------------------------------------------------- |
| Hunyuan3D-DiT-v2-mv-Fast | ガイダンス蒸留バージョン、DIT 推論時間を半分に短縮可能                  | 2025-03-18 | 1.1B  | [訪問](https://huggingface.co/tencent/Hunyuan3D-2mv/tree/main/hunyuan3d-dit-v2-mv-fast) |
| Hunyuan3D-DiT-v2-mv      | マルチビュー画像から形状モデル、シーンを理解するために複数の角度が必要な 3D 制作に適する | 2025-03-18 | 1.1B  | [訪問](https://huggingface.co/tencent/Hunyuan3D-2mv/tree/main/hunyuan3d-dit-v2-mv)      |

**Hunyuan3D-2 シリーズ**

| モデル                     | 説明         | 日付         | パラメータ | Huggingface                                                                        |
| ----------------------- | ---------- | ---------- | ----- | ---------------------------------------------------------------------------------- |
| Hunyuan3D-DiT-v2-0-Fast | ガイダンス蒸留モデル | 2025-02-03 | 1.1B  | [訪問](https://huggingface.co/tencent/Hunyuan3D-2/tree/main/hunyuan3d-dit-v2-0-fast) |
| Hunyuan3D-DiT-v2-0      | 画像から形状モデル  | 2025-01-21 | 1.1B  | [訪問](https://huggingface.co/tencent/Hunyuan3D-2/tree/main/hunyuan3d-dit-v2-0)      |
| Hunyuan3D-Paint-v2-0    | テクスチャ生成モデル | 2025-01-21 | 1.3B  | [訪問](https://huggingface.co/tencent/Hunyuan3D-2/tree/main/hunyuan3d-paint-v2-0)    |
| Hunyuan3D-Delight-v2-0  | 画像デライトモデル  | 2025-01-21 | 1.3B  | [訪問](https://huggingface.co/tencent/Hunyuan3D-2/tree/main/hunyuan3d-delight-v2-0)  |