Hunyuan3D 2.0 ComfyUIワークフロー完全ガイド、ComfyUI-Huanyuan3DWrapperとComfyUIネイティブサポートワークフロー例

Hunyuan3D-2はテンセントが提供するオープンソースの3D生成モデルシリーズです。2025年3月時点で最新バージョンは2.0であり、テキスト、画像、またはスケッチを通じて高解像度テクスチャマップを備えた高忠実度3Dモデルの生成をサポートしています。

技術的ハイライト

このシステムは、ジオメトリ生成とテクスチャ合成を分離したプロセスを採用しています：

• ジオメトリ生成（Hunyuan3D-DiT）：テクスチャのない3D幾何モデルを生成するフロー拡散モデルに基づき、2.6Bパラメータを持ち、入力画像やテキストから幾何情報を正確に抽出できます。
• テクスチャ合成（Hunyuan3D-Paint）：幾何モデルに高解像度（4K）テクスチャを追加し、1.3Bパラメータを持ち、リアルなテクスチャと一貫した照明を確保するためのマルチビュー拡散生成技術をサポートしています。

形状とテクスチャの生成を分離することで、複雑さを効果的に軽減し、生成品質を向上させています。

パフォーマンスと効率の最適化

• 高速生成：最速30秒でモデル生成を完了し、加速版（Hunyuan3D-DiT-v2-0-Fast）はガイダンス蒸留技術により推論時間を50%短縮します。
• マルチモーダル入力：テキスト説明、画像、スケッチなど様々な入力方法をサポートし、Blenderプラグインやグラディオアプリケーションと互換性があり、使用のハードルを下げています。

オープンソースモデルエコシステム このプロジェクトは6つのモデル（一部は簡略版）をオープンソース化し、様々なシナリオのニーズをカバーしています：

• Hunyuan3D-2mv：マルチビュー形状生成モデルで、複雑なシーンのモデリングに適しています。
• Hunyuan3D-Delight-v2-0：画像のライティング除去モデルで、照明に依存しないテクスチャを生成します。 その他のモデルには、軽量版（2mini）、高忠実度のジオメトリ生成（DiT-v2-0）などがあります。

以下は、ComfyUIに依存せずにHunyuan3D 2.0を体験できるオンラインプラットフォームまたは実装です：

• Hunyuan3D-2mvオンライン体験
• Hunyuan3D-2オンライン体験
• Hunyuan3Dホームページ
• Hunyuan3D-2-WinPortable

ここからは、ComfyUIにおけるHunyuan3D 2.0モデル生成の実装アプローチを紹介します。

ComfyUIにおけるHunyuan3D 2.0モデル生成の実装アプローチ

以下は、このガイドでカバーする主なアプローチです。それぞれについて、完全なワークフローとステップバイステップのチュートリアルを提供します。

ComfyUI-Hunyuan3DWrapper

Kijaiによって開発されたこのプラグインは、現在ComfyUIにおいて最も完全なサポートとパフォーマンスを提供し、モデルからテクスチャまでの完全なレンダリング出力を実装できます。ただし、テクスチャ生成部分は別のコンポーネントのコンパイルが必要で、Pythonの仮想環境とpipコマンドの基本的な知識が必要です。

ComfyUIネイティブサポート

ComfyUIは現在、Hunyuan3D 2.0と2mvシリーズモデルを公式にサポートし、モデルのレンダリングが可能です。ただし、まだテクスチャレンダリングはサポートしておらず、独自の美的魅力を持つボクセルモデルを出力します。ComfyUIの最新バージョンに更新するだけで使用でき、使用と体験が簡単です。

ComfyUI 3D Pack Installation

このプラグインの主な問題は、その依存環境が最新のComfyUI依存環境と異なるため、インストールが非常に困難なことです。何度も試しましたが成功しなかったため、この記事では関連部分とリソースの紹介のみを提供できます。

入力画像

この例では複数のワークフローが関係しているため、対応する入力画像を提供します。これらの素材はすべてComfyUI公式ドキュメントで使用されているサンプル画像からのものですが、自分の画像を使用することもできます。

ComfyUI-Hunyuan3DWrapperプラグインはComfyUI-essentialsプラグインノードを使用して自動背景除去を完了しますが、ComfyUIネイティブサポートワークフローはこの機能を提供しないため、ここで提供される画像はすでに処理されています。自分の画像を使用する場合は、ComfyUI-Hunyuan3DWrapperプラグインの背景除去部分を参照してください。

ComfyUI-Hunyuan3DWrapper Hunyuan3D 2.0ワークフロー

このセクションでは、ComfyUI-Hunyuan3DWrapperプラグインを使用してHunyuan3D 2.0モデル生成を実装します。対応するワークフローを再構成し、ワークフローファイルにモデルダウンロードリンクを追加しました。

1. 関連プラグインのインストール

Kijaiのワークフローは以下の2つのプラグインに依存しています：

• ComfyUI-Hunyuan3DWrapper
• ComfyUI_essentials

ComfyUI Managerを通じてこれらのプラグインをインストールできます。

1.1 基本プラグイン依存関係のインストール

この部分はComfyUIプラグインのインストールに慣れている読者には馴染みがあるでしょう。ComfyUI Managerを通じてプラグインをインストールした場合、依存関係は自動的にインストールされるはずです。

手動またはgitを介してインストールした場合は、対応するComfyUI仮想環境で依存関係インストールコマンドを実行する必要があります。

ComfyUIプラグインインストールガイドの最後にある依存関係インストールセクションを参照して完了してください。

1.2 テクスチャ生成コンポーネントのインストール

**ComfyUI

ComfyUIネイティブHunyuan3D 2.0ワークフロー

ComfyUIは現在、Hunyuan3D-2mvシリーズモデルをネイティブにサポートし、3D幾何モデルを直接生成できます（現在テクスチャ材質なし）。ComfyUIを最新バージョンにアップグレードするだけでこれを体験できます。

ComfyUI WikiはComfy公式ドキュメントを維持するためにComfy公式と協力を開始し、このコンテンツ部分はComfy公式ドキュメントで詳しく説明されています。 しかし、公式ドキュメントは現在中国語と英語のみをサポートしています。ComfyUI Wikiの読者の便宜のために、ComfyUI Wikiはdocs.comfy.orgで元々公開されたコンテンツを私たちのサイトで再構成・編集しました。

ComfyUIは現在、Hunyuan3D 2.0とHunyuan3D-2mvシリーズモデルの3つの主要なネイティブワークフローを提供しています：

• Hunyuan3D-2mvマルチビューワークフロー
• Hunyuan3D-2mv-turbo加速マルチビューワークフロー
• Hunyuan3D-2単一視点ワークフロー

これらのワークフローは、ComfyUIの最新バージョンのワークフローテンプレートに追加されています。メニューバーのワークフロー -> ワークフローテンプレート -> 3dで見つけることができます。

1. Hunyuan3D-2mvマルチビューワークフローの使用

1.1 ワークフロー例

以下の画像をダウンロードしてComfyUIにドラッグすると、関連するモデルのダウンロードを自動的に完了するよう促されます。

1.2 手動モデルインストール

hunyuan3d-dit-v2-mv.safetensorsをダウンロードし、ComfyUI/models/checkpoints/ディレクトリに保存し、hunyuan3d-dit-v2-mv.safetensorsに名前を変更します。

1.3 ステップバイステップのワークフロー実行

1. Image Only Checkpoint Loader(img2vid model)ノードがhunyuan3d-dit-v2-mv.safetensorsモデルをロードしていることを確認します
2. 各Load Imageノードに対応する角度の画像をロードします
3. ワークフローを実行して3Dモデルを生成します

2. Hunyuan3D-2mv-turbo加速ワークフローの使用

Hunyuan3D-2mv-turboはHunyuan3D-2mvの蒸留バージョンで、より高速な実行を提供します。

2.1 ワークフロー例

以下の画像をダウンロードしてComfyUIにドラッグすると、関連するモデルのダウンロードを自動的に完了するよう促されます。

2.2 手動モデルインストール

hunyuan3d-dit-v2-mv-turbo.safetensorsをダウンロードし、hunyuan3d-dit-v2-mv-turbo.safetensorsに名前を変更し、ComfyUI/models/checkpoints/ディレクトリに保存します。

2.3 ステップバイステップのワークフロー実行

1. Image Only Checkpoint Loader(img2vid model)ノードがhunyuan3d-dit-v2-mv-turbo.safetensorsモデルをロードしていることを確認します
2. 各Load Imageノードに対応する角度の画像をロードします
3. このワークフローでは、cfgが1.0に設定され、蒸留cfg生成を制御するflux guidanceノードが追加されていることに注意してください
4. ワークフローを実行して3Dモデルを生成します

3. Hunyuan3D-2単一視点ワークフローの使用

Hunyuan3D-2モデルは単一視点入力からの3Dモデル生成をサポートしています。

3.1 ワークフロー例

以下の画像をダウンロードしてComfyUIにドラッグすると、関連モデルのダウンロードを自動的に促されます。

3.2 入力画像例

3.3 手動モデルインストール

hunyuan3d-dit-v2.safetensorsをダウンロードし、hunyuan3d-dit-v2.safetensorsにリネームして、ComfyUI/models/checkpoints/ディレクトリに保存します。

3.4 ステップバイステップのワークフロー実行

1. Image Only Checkpoint Loader(img2vid model)ノードでhunyuan3d-dit-v2.safetensorsモデルがロードされていることを確認します
2. Load Imageノードに入力画像をロードします
3. このワークフローではHunyuan3Dv2ConditioningMultiViewではなくHunyuan3Dv2Conditioningノードを使用していることに注意してください
4. ワークフローを実行して3Dモデルを生成します

ComfyUI 3D Pack

ComfyUI 3D Packをインストールする際の主な問題は依存関係の競合です。プラグインの環境要件は最新のComfyUIバージョンのものとは異なり、特にPyTorchとCUDAバージョンのサポートに関して違いがあります。試してみたい場合は、ComfyUI-3D-Packプロジェクトのインストール手順を参照してください。 また、コミュニティユーザーが統合パッケージを提供しており、Comfy3D-WinPortable | 統合パッケージを試すことができます。

追加コンテンツ

テキストからモデルを生成する方法

上記のワークフローでは入力画像を使用しました。これらのワークフローの前にテキストから画像へのワークフローを追加して、対応する画像コンテンツを生成できます。マルチビュー入力が必要な場合は、ComfyUI-MVAdapterプラグインを使用して、対応するキャラクターの複数角度画像を生成することを試みることができます。

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

Hunyuan3D 2.0は完全な3D生成プロセスをカバーする複数のモデルをオープンソース化しています。詳細はHunyuan3D-2をご覧ください。

Hunyuan3D-2miniシリーズ

Hunyuan3D-2mvシリーズ

Hunyuan3D-2シリーズ

Hunyuan 3D 2.0関連リンク

• Hunyuan3Dホームページ: https://3d.hunyuan.tencent.com
• Hunyuan3D-2デモ: https://huggingface.co/spaces/tencent/Hunyuan3D-2
• Hunyuan3D-2モデル: https://huggingface.co/Tencent/Hunyuan3D-2
• Hunyuan3D-2mvモデル: https://huggingface.co/tencent/Hunyuan3D-2mv
• Hunyuan3D-2mvデモ: https://huggingface.co/spaces/tencent/Hunyuan3D-2mv
• GitHub: https://github.com/Tencent/Hunyuan3D-2
• Discord: https://discord.gg/GuaWYwzKbX
• レポート: https://github.com/Tencent/Hunyuan3D-2/blob/main/assets/report/Tencent_Hunyuan3D_2_0.pdf
• 公式ウェブサイト: http://3d-models.hunyuan.tencent.com