Skip to content
より良い ComfyUI ナレッジベースの構築を支援する サポーターになる
チュートリアルシリーズComfyUI 上級チュートリアル3dHunyuan3D 2.0

FramePack: 動画生成のための効率的な次フレーム予測モデル

2025/04/17

Hunyuan3D 2.0完全ガイド：ComfyUIネイティブサポートとComfyUI-Hunyuan3DWrapperを含む

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

オープンソースモデルエコシステム このプロジェクトは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-Huanyuan3DWrapperプラグインの背景除去部分を参照してください。

input imageinput imageinput image
input imageinput imageinput 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 テクスチャ生成コンポーネントのインストール

様々な環境向けのプリコンパイルされたホイールファイルをインストールする手順は以下の通りです。システムに一致するバージョンがない場合は、自己コンパイルインストールセクションを参照してください。

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を使用して適切なホイールファイルをインストールします、例えば：
pip install custom_rasterizer-0.1-cp312-cp312-win_amd64.whl

システムに応じて特定のバージョンを選択してください。

1.2.2 自己コンパイルインストール（プリコンパイルされたファイルがシステムに合わない場合）

プリコンパイルされたホイールファイルがシステムに合わない場合は、自分でコンパイルする必要があります：

ラスタライザーのコンパイルとインストール：

セクション1.2.1を参照してDesktopバージョンターミナルにアクセスし、cdコマンドを使用して適切なフォルダに移動してからインストールを実行します：

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コマンドを使用して適切なフォルダに移動してからインストールを実行します：

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コマンドを使用して適切なフォルダに移動してからインストールを実行します：

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をアップグレードできます：

まず現在のバージョンを削除します：

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. Queueボタンをクリックするかショートカット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/ディレクトリに保存できます。

💡

生成速度が遅すぎる場合は、以下を試すことができます：

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

  • 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. ComfyUIネイティブ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関連リンク