Hunyuan3D 2.0 ComfyUIワークフロー：シングルビュー・マルチビュー3D生成ガイド

Hunyuan3D 2.0のComfyUIワークフローガイド：ComfyUI-Hunyuan3DWrapperカスタムノードとネイティブサポートによる、シングルビューおよびマルチビューの3D生成を解説。モデルのダウンロードリンク付き。

Hunyuan 3D 2 Hunyuan 3D 2

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プラグインやGradioアプリケーションと互換性があり、使用のハードルを下げています。

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

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

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

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

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

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

ComfyUI-Hunyuan3DWrapper

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

ComfyUI-Hunyuan3DWrapperの例

ComfyUIネイティブサポート

ComfyUI-Hunyuan3DWrapperの例

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

ComfyUI 3D Packのインストール

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

入力画像

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

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

input image input image input image
input image input image input image

ComfyUI-Hunyuan3DWrapper Hunyuan3D 2.0ワークフロー

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

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

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

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

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

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

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

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

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

ComfyUI-Hunyuan3DWrapperの基本依存関係をインストールした後、テクスチャ生成に必要なコンポーネントをコンパイルしてインストールする必要があります。作者は特定の環境向けに事前コンパイル済みのwheelファイルを提供しています。

作者はこれらのファイルを対応するディレクトリに提供し、プラグインのReadmeで使用方法を説明しています。ComfyUI Wikiの読者は多言語のユーザーであることを考慮し、この部分の内容を翻訳・整理しました。 Hunyuan3Dwrapper-dependencies

1.2.1 事前コンパイル済みwheelファイルのインストール

以下は、異なる環境向けの事前コンパイル済みwheelファイルのインストール手順です。お使いの環境に一致するバージョンがない場合は、自己コンパイルによるインストールセクションを参照してください。

Windows 11 Python 3.12 CUDA 12.6環境の場合： 
pip install wheels\custom_rasterizer-0.1-cp312-cp312-win_amd64.whl

ComfyUI Desktop版の場合は、以下の手順に従って対応する環境でインストールを完了できます：

Desktop版を起動した後、下の画像のようにターミナルを開く必要があります。Python環境はすでにアクティベートされているため、このターミナルで直接インストールコマンドを実行できます。

Desktop版
  1. Desktop版を起動した後、右上隅のトグルボタンをクリックして下部のログパネルを開きます
  2. 下部パネルでterminalタブを選択してターミナルを開きます
  3. ターミナルでインストールコマンドを実行します：
pip install ComfyUI\custom_nodes\ComfyUI-Hunyuan3DWrapper\wheels\custom_rasterizer-0.1-cp312-cp312-win_amd64.whl

この方法ではファイルが見つからないという問題を報告するユーザーもいるため、cdコマンドを使用して適切なフォルダーに移動することもできます：

cd custom_nodes\ComfyUI-Hunyuan3DWrapper\wheels
  1. lsを使用してwheelsフォルダー内のファイルを一覧表示します
  2. pip installを使用して適切なwheelファイルをインストールします。例えば：
pip install custom_rasterizer-0.1-cp312-cp312-win_amd64.whl

お使いのシステムに応じて具体的なバージョンを選択してください。

1.2.2 自己コンパイルによるインストール（事前コンパイル済みファイルがシステムで動作しない場合）

事前コンパイル済みのwheelファイルがお使いのシステムで動作しない場合は、自分でコンパイルする必要があります：

Rasterizerのコンパイルとインストール：

セクション1.2.1を参照してDesktop版のターミナルにアクセスし、cdコマンドを使用して適切なフォルダーに移動してインストールを実行してください： ```bash cd custom_nodes/ComfyUI-Hunyuan3DWrapper/hy3dgen/texgen/custom_rasterizer python setup.py install ```

インストールが成功すると、Python環境のsite-packagesフォルダーにcustom_rasterizer_kernel*.pydファイルとcustom_rasterizerフォルダーが表示されるはずです。

mesh_processor拡張のコンパイル：

セクション1.2.1を参照してDesktop版のターミナルにアクセスし、cdコマンドを使用して適切なフォルダーに移動してインストールを実行してください： ```bash cd custom_nodes/ComfyUI-Hunyuan3DWrapper/hy3dgen/texgen/differentiable_renderer python setup.py build_ext --inplace ```

このファイルはそのフォルダーに存在するはずです。これは頂点修正にのみ使用され、このファイルが存在しない場合はCPUでフォールバックが実行され、はるかに遅くなります。頂点修正は別のノードにあるため、最悪の場合バイパスできますが、テクスチャの充填が不十分になるという欠点があります。

1.3 オプションのインストール：BPT（Boundary Preserving Transform）

このコンポーネントは完全にオプションですが、インストール要件が高いです：

セクション1.2.1を参照してDesktop版のターミナルにアクセスし、cdコマンドを使用して適切なフォルダーに移動してインストールを実行してください： ```bash cd custom_nodes/ComfyUI-Hunyuan3DWrapper/hy3dgen/shapegen/bpt pip install -r requirements.txt ```

重みファイルをダウンロード：bpt-8-16-500m.pt

bpt-8-16-500m.ptをComfyUI-Hunyuan3DWrapper-main\hy3dgen\shapegen\bptディレクトリにコピーします。

1.4 ハイポリゴンモデルのUVマッピングを修正するためのXatlasのアップグレード

ハイポリゴンモデルのUVマッピングの問題を修正するには、Xatlasをアップグレードできます：

まず現在のバージョンをアンインストールします： ```bash python_embeded\python.exe -m pip uninstall xatlas ```

ポータブルのルートディレクトリ（ComfyUI_windows_portable）で：

git clone --recursive https://github.com/mworchel/xatlas-python.git
cd .\xatlas-python\extern

xatlasフォルダーを削除してから、新しいバージョンをクローンします：

git clone --recursive https://github.com/jpcy/xatlas

xatlas-python\extern\xatlas\source\xatlasで、xatlas.cppファイルを変更します：

  • 6774行目を#if 0から//#if 0に変更
  • 6778行目を#endifから//#endifに変更

最後に、ポータブルのルートディレクトリ（ComfyUI_windows_portable）に戻り、実行します：

.\python_embeded\python.exe -m pip install .\xatlas-python\

2. Hunyuan3D 2.0シングルビューワークフロー

Hunyuan3D 2.0モデルはマルチビューモデルではないため、ComfyUI-Hunyuan3DWrapperを使用する際は、Hunyuan3D-DiT-v2-mvシリーズではなくHunyuan3D-DiT-v2-0シリーズのモデルを使用する必要があります。このプラグインはモデルのジオメトリ生成だけでなく、テクスチャ生成もサポートしており、完全な3Dモデルを作成できます。

2.1 ワークフローファイル

以下のワークフローファイルをダウンロードしてComfyUIにドラッグすると、関連するモデルのダウンロードを完了するよう自動的にプロンプトが表示されます。

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

Hunyuan3D 2.0が最初にリリースされたとき、safetensors形式のモデルは提供されていなかったため、Kijaiが変換版を提供しました。しかし、Hunyuan3D 2.0は現在safetensors形式のモデルを提供しています。以下のモデルのいずれかをダウンロードし、ComfyUI/models/diffusion_models/ディレクトリに保存してください。

2.3 画像を使用したワークフローの実行

Hunyuan3DWrapper_singleview_1 Hunyuan3DWrapper_singleview_2

  1. Hy3DModelLoaderノードでhunyuan3d-dit-v2-0.safetensorsが読み込まれていることを確認します
  2. モデル生成のためにLoad Imageノードで対応する入力画像を読み込みます
  3. Runボタンをクリックするか、ショートカットCtrl(cmd) + Enterを使用してワークフローを実行します
custom_rasterizerに関するエラーが発生した場合は、プラグインのインストールセクションを参照して、依存コンポーネントをインストールまたはコンパイルする方法を確認してください。 出力モデルは、Hy3DExportMeshノードで設定されているように、ComfyUI/output/3Dフォルダーに保存されます。

3. Hunyuan3D 2.0マルチビューワークフロー

3.1 ワークフローファイル

以下のワークフローファイルをダウンロードしてComfyUIにドラッグすると、関連するモデルのダウンロードを完了するよう自動的にプロンプトが表示されます。

3.2 手動でのモデルインストール

Hunyuan3D 2mvマルチビューモデルは前のものと似ています。Kijaiも初期の変換版を提供しており、後にTencentがsafetensors版を提供しました。以下のモデルのいずれかをダウンロードし、ComfyUI/models/diffusion_models/ディレクトリに保存してください。

生成が遅すぎる場合は、以下を使用してみてください： - Hunyuan3D-2mv-turbo - Hunyuan3D-2mv-fast

3.3 画像を使用したワークフローの実行

Hunyuan3DWrapper_multiview_1 Hunyuan3DWrapper_multiview_2

  1. Hy3DModelLoaderノードでhunyuan3d-dit-v2-mv-fp16.safetensorsが読み込まれていることを確認します
  2. Load Imageノードで異なる角度の入力画像をアップロードします。特定の角度の画像がない場合は、対応するノードを右クリックしてモードをNeverに設定します
  3. Runボタンをクリックするか、ショートカットCtrl(cmd) + Enterを使用してワークフローを実行します

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

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

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

ComfyUIは現在3つのネイティブワークフローを提供しており、主にHunyuan3D 2.0およびHunyuan3D-2mvシリーズモデルをサポートしています：

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

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

ComfyUIネイティブワークフローテンプレート
このセクションを始める前に、ComfyUIの最新バージョンにアップグレードしていることを確認してください。ComfyUIアップデートガイドを参照してComfyUIを更新できます。 - ComfyUI-Hunyuan3DWrapperと比較して、ネイティブワークフローは対応するモデルをComfyUI/models/checkpoints/ディレクトリに保存します。モデル自体は同じですので、以前にComfyUI-Hunyuan3DWrapperプラグインワークフローを使用していた場合は、モデルの保存ディレクトリを適宜調整してください。 - .glbファイルの出力先は、SaveGLBノードで設定されているComfyUI/output/meshディレクトリです。

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

1.1 ワークフロー例

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

Hunyuan3D-2mvワークフロー

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

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

1.3 ワークフロー実行の手順

Hunyuan3D-2mvワークフロー
  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にドラッグすると、関連するモデルのダウンロードを自動的に促されます。

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

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

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

2.3 ワークフロー実行の手順

Hunyuan3D-2mv-turboワークフロー
  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にドラッグすると、関連するモデルのダウンロードを自動的に促されます。

Hunyuan3D-2ワークフロー

3.2 入力画像例

入力画像

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

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

3.4 ワークフロー実行の手順

ComfyUIネイティブ
  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シリーズ

モデル説明日付パラメータHuggingface
Hunyuan3D-DiT-v2-miniミニ画像から形状へのモデル2025-03-180.6Bリンク

Hunyuan3D-2mvシリーズ

モデル説明日付パラメータHuggingface
Hunyuan3D-DiT-v2-mv-Fastガイダンス蒸留版で、DIT推論時間を半分に短縮可能2025-03-181.1Bリンク
Hunyuan3D-DiT-v2-mv複数の角度を必要とする3D作成に最適なマルチビュー画像から形状へのモデル2025-03-181.1Bリンク

Hunyuan3D-2シリーズ

モデル説明日付パラメータHuggingface
Hunyuan3D-DiT-v2-0-Fastガイダンス蒸留モデル2025-02-031.1Bリンク
Hunyuan3D-DiT-v2-0画像から形状へのモデル2025-01-211.1Bリンク
Hunyuan3D-Paint-v2-0テクスチャ生成モデル2025-01-211.3Bリンク
Hunyuan3D-Delight-v2-0画像デライティングモデル2025-01-211.3Bリンク

Hunyuan 3D 2.0関連リンク

コメント

GitHubでサインインしてディスカッションに参加しましょう。

コメントを読み込み中…