> ## Documentation Index
> Fetch the complete documentation index at: https://docs.comfy.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Hunyuan3D 2.0 / 2.1: ComfyUI 画像から3Dメッシュへのワークフロー

> テンセントのオープンソースモデル Hunyuan3D 2.0、2.1、turbo を使い、ComfyUI で単一画像または4方向のビューから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）も導入し、異なる角度からの入力からより詳細な幾何構造を生成できるようになりました。

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

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

> [!TIP]
>
> ComfyUI は現在 Hunyuan3D-2mv をネイティブサポートしていますが、テクスチャとマテリアルの生成はまだサポートしていません。開始する前に、最新バージョンの [ComfyUI](https://github.com/Comfy-Org/ComfyUI) にアップデートされていることを確認してください。
>
> このチュートリアルのワークフロー例 PNG 画像には、メタデータにワークフロー JSON が含まれています：
>
> * ComfyUI に直接ドラッグできます
> * またはメニュー `Workflows` -> `Open (ctrl+o)` を使用できます
>
> これにより、対応するワークフローが読み込まれ、必要なモデルのダウンロードを促されます。生成された `.glb` 形式のモデルは `ComfyUI/output/mesh` フォルダに出力されます。

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

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

> [!TIP]
>
> > [tab] ローカルユーザー
> >
> > ComfyUI が最新版に更新されていることを確認してください。
> >
> > * [ComfyUI のダウンロード](https://www.comfy.org/download)
> > * [更新手順](https://docs.comfy.org/ja/installation/update_comfyui.md)
> >
> > このガイドで紹介するワークフローは、[ワークフローテンプレート](https://docs.comfy.org/ja/interface/features/template.md)から入手できます。
> > テンプレート内に該当のワークフローが見つからない場合、ComfyUI のバージョンが古くなっている可能性があります。
> >
> > ワークフローを読み込んだ際にノードが欠落している場合の考えられる原因：
> >
> > 1. 最新の ComfyUI（Nightly 版）を使用していない
> > 2. 起動時に一部のノードのインポートに失敗している
>
> > [tab] クラウドユーザー
> >
> > * [Cloud](https://cloud.comfy.org) は、ComfyUI の安定版リリース後に更新されます。
> >
> > したがって、このドキュメントでコアノードが見つからない場合、それは新しいコアノードがまだ最新の安定版にリリースされていない可能性があります。次回の安定版リリースをお待ちください。

### HY 3D 2.0 MV

Hunyuan3D 2.0 MV を使用して、複数のビューから 3D モデルを生成します。

![HY 3D 2.0 MV ワークフロープレビュー](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/3d_hunyuan3d_multiview_to_model-1.webp)

> [card] [Comfy Cloud で実行](https://cloud.comfy.org/?template=3d_hunyuan3d_multiview_to_model\&utm_source=docs\&utm_medium=referral\&utm_campaign=hunyuan3D-2)
>
> このワークフローを Comfy Cloud ですぐに実行

> [card] [ワークフローをダウンロード](https://github.com/Comfy-Org/workflow_templates/blob/main/templates/3d_hunyuan3d_multiview_to_model.json)
>
> JSON をダウンロードするか、テンプレート ライブラリで "HY 3D 2.0 MV" を検索してください

**入力素材**

以下のファイルを対応する `LoadImage` ノードにアップロードします：

> [card] [3d\_hunyuan3d\_multiview\_to\_model\_front\_image.png](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/3d_hunyuan3d_multiview_to_model_front_image.png)
>
> `LoadImage` ノード 56 · 正面ビュー

> [card] [3d\_hunyuan3d\_multiview\_to\_model\_left\_image.png](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/3d_hunyuan3d_multiview_to_model_left_image.png)
>
> `LoadImage` ノード 78 · 左ビュー

> [card] [3d\_hunyuan3d\_multiview\_to\_model\_back\_image.png](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/3d_hunyuan3d_multiview_to_model_back_image.png)
>
> `LoadImage` ノード 80 · 背面ビュー

> [card] [3d\_hunyuan3d\_multiview\_to\_model\_right\_image.png](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/3d_hunyuan3d_multiview_to_model_right_image.png)
>
> `LoadImage` ノード 87 · 右ビュー

### 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) のようなカスタムノードを使用して、余分な背景を自動的に除去できます。

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

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

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

```
ComfyUI/
├── models/
│   ├── checkpoints/
│   │   └── hunyuan3d-dit-v2-mv.safetensors  // 名前を変更したファイル
```

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

![ComfyUI hunyuan3d\_2mv](https://mintcdn.com/dripart/NmGUk_QSXQXRVtZP/images/tutorial/3d/hunyuan3d-2mv/hunyuan3d_2mv.jpg?fit=max\&auto=format\&n=NmGUk_QSXQXRVtZP\&q=85\&s=17e6ac738f0e0133536bceb6e3ea1b56)

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` 生成を制御します。

### HY 3D 2.0 MV Turbo

複数のビューから Hunyuan3D 2.0 MV Turbo を使用して 3D モデルを生成します。

![HY 3D 2.0 MV Turbo ワークフローのプレビュー](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/3d_hunyuan3d_multiview_to_model_turbo-1.webp)

> [card] [Comfy Cloud で実行](https://cloud.comfy.org/?template=3d_hunyuan3d_multiview_to_model_turbo\&utm_source=docs\&utm_medium=referral\&utm_campaign=hunyuan3D-2)
>
> Comfy Cloud でこのワークフローを即座に実行

> [card] [ワークフローをダウンロード](https://github.com/Comfy-Org/workflow_templates/blob/main/templates/3d_hunyuan3d_multiview_to_model_turbo.json)
>
> JSON をダウンロードするか、テンプレートライブラリで "HY 3D 2.0 MV Turbo" を検索

**入力マテリアル**

以下のファイルを該当する `LoadImage` ノードにアップロードします。

> [card] [3d\_hunyuan3d\_multiview\_to\_model\_turbo\_front\_view.png](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/3d_hunyuan3d_multiview_to_model_turbo_front_view.png)
>
> `LoadImage` ノード 56 · 正面ビュー

> [card] [3d\_hunyuan3d\_multiview\_to\_model\_turbo\_back\_view.png](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/3d_hunyuan3d_multiview_to_model_turbo_back_view.png)
>
> `LoadImage` ノード 82 · 背面ビュー

> [card] [3d\_hunyuan3d\_multiview\_to\_model\_turbo\_left\_view.png](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/3d_hunyuan3d_multiview_to_model_turbo_left_view.png)
>
> `LoadImage` ノード 85 · 左ビュー

> [card] [3d\_hunyuan3d\_multiview\_to\_model\_turbo\_right\_view.png](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/3d_hunyuan3d_multiview_to_model_turbo_right_view.png)
>
> `LoadImage` ノード 87 · 右ビュー

### 1. ワークフロー

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

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

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

![入力画像](https://raw.githubusercontent.com/Comfy-Org/example_workflows/main/3d/hunyuan3d-2/hunyuan3d_2mv_turbo/front.png)
![入力画像](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/blob/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. ワークフローの実行手順

![ComfyUI hunyuan3d\_2mv\_turbo](https://mintcdn.com/dripart/NmGUk_QSXQXRVtZP/images/tutorial/3d/hunyuan3d-2mv/hunyuan3d_2mv_turbo.jpg?fit=max\&auto=format\&n=NmGUk_QSXQXRVtZP\&q=85\&s=33bb861fd695fd4b10a53345f004d2cc)

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` ノードを使用します。

### HY 3D 2.0

Hunyuan3D 2.0 を使用して、単一の画像から 3D モデルを生成します。

![HY 3D 2.0 ワークフロープレビュー](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/3d_hunyuan3d_image_to_model-1.webp)

> [card] [Comfy Cloud で実行](https://cloud.comfy.org/?template=3d_hunyuan3d_image_to_model\&utm_source=docs\&utm_medium=referral\&utm_campaign=hunyuan3D-2)
>
> このワークフローを Comfy Cloud ですぐに実行

> [card] [ワークフローのダウンロード](https://github.com/Comfy-Org/workflow_templates/blob/main/templates/3d_hunyuan3d_image_to_model.json)
>
> JSON をダウンロードするか、テンプレートライブラリで "HY 3D 2.0" を検索

**入力素材**

以下のファイルを該当する `LoadImage` ノードにアップロードします。

> [card] [3d\_hunyuan3d\_image\_to\_model\_input\_image.png](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/3d_hunyuan3d_image_to_model_input_image.png)
>
> `LoadImage` ノード 56 · `3d_hunyuan3d_image_to_model_input_image.png`

### 1. ワークフロー

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

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

以下の画像をダウンロードしてください。これを入力画像として使用します。
![ComfyUI Hunyuan 3D 2 ワークフロー](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/blob/main/hunyuan3d-dit-v2-0/model.fp16.safetensors?download=true) - ダウンロード後、`hunyuan3d-dit-v2.safetensors` に名前を変更できます。

```
ComfyUI/
├── models/
│   ├── checkpoints/
│   │   └── hunyuan3d-dit-v2.safetensors  // 名前を変更したファイル
```

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

![ComfyUI hunyuan3d\_2](https://mintcdn.com/dripart/NmGUk_QSXQXRVtZP/images/tutorial/3d/hunyuan3d-2mv/hunyuan3d_2_non_multiview.jpg?fit=max\&auto=format\&n=NmGUk_QSXQXRVtZP\&q=85\&s=33c158fcfb133560674aa56bfdb5087d)

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

## Hunyuan3D 2.1 単一ビューワークフロー

Hunyuan3D 2.1 は、2025 年 6 月にテンセントがリリースした 3D 形状生成モデルで、Hunyuan3D 2.0 の幾何形状の品質をさらに高めたバージョンです。ComfyUI 用に再パッケージされた checkpoint は形状生成のパイプラインを 1 つのファイルにまとめているため、このワークフローでは DiT と VAE を別々にダウンロードする必要はありません。このページの他のワークフローと同様、出力はテクスチャなしのメッシュです。

### HY 3D 2.1

Hunyuan3D 2.1 を使用して、単一の画像から 3D メッシュを生成します。

![HY 3D 2.1 ワークフロープレビュー](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/templates/3d_hunyuan3d-v2.1-1.webp)

> [card] [Comfy Cloud で実行](https://cloud.comfy.org/?template=3d_hunyuan3d-v2.1\&utm_source=docs\&utm_medium=referral\&utm_campaign=hunyuan3D-2)
>
> このワークフローを Comfy Cloud ですぐに実行

> [card] [ワークフローのダウンロード](https://github.com/Comfy-Org/workflow_templates/blob/main/templates/3d_hunyuan3d-v2.1.json)
>
> JSON をダウンロードするか、テンプレートライブラリで "HY 3D 2.1" を検索

**入力素材**

以下のファイルを該当する `LoadImage` ノードにアップロードします。

> [card] [3d\_hunyuan3d-v2.1\_input\_image.png](https://raw.githubusercontent.com/Comfy-Org/workflow_templates/main/input/3d_hunyuan3d-v2.1_input_image.png)
>
> `LoadImage` ノード 2 · `3d_hunyuan3d-v2.1_input_image.png`

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

以下の checkpoint をダウンロードし、`checkpoints` フォルダーに保存してください。

> [card] [hunyuan\_3d\_v2.1.safetensors](https://huggingface.co/Comfy-Org/hunyuan3D_2.1_repackaged/blob/main/hunyuan_3d_v2.1.safetensors)
>
> `ComfyUI/models/checkpoints/` に配置

```
📂 ComfyUI/
├── 📂 models/
│   └── 📂 checkpoints/
│       └── hunyuan_3d_v2.1.safetensors
```

ファイルサイズは約 7.4 GB です。

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

1. `Image Only Checkpoint Loader(img2vid model)` ノードに `hunyuan_3d_v2.1.safetensors` が読み込まれていることを確認します
2. `Load Image` ノードで参照画像を読み込みます
3. `Queue` ボタンをクリックするか、ショートカット `Ctrl(cmd) + Enter` でワークフローを実行します

生成された `.glb` メッシュは `ComfyUI/output/mesh/` に保存されます。

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

以下は 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) |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.