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

バイトダンス、InfiniteYouをリリース：ユーザーのアイデンティティを保持しながら柔軟な写真再構築が可能に

2025/03/21

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-Hunyuan3DWrapperプラグインの背景除去部分を参照してください。

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

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

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

1.2.1 プリコンパイルされたホイールファイルのインストール

現在、xatlas依存関係のバージョンが進化したため、多くの場合、単純なインストールではコンパイルエラーが発生します。そのため、プラグイン作者は以下のように特定の環境用にプリコンパイルされたホイールファイルを提供しています：

対応するホイールファイルをダウンロードし、ComfyUIの対応する仮想環境にインストールします：

pip install "https://github.com/kijai/ComfyUI-Hunyuan3DWrapper/releases/download/v0.0.1/xatlas-0.0.1-cp310-cp310-win_amd64.whl"
1.2.2 手動コンパイル方法

プリコンパイルされたホイールファイルがない、または環境が一致しない場合は、手動でコンパイルする必要があります。ここでは関連する方法のみを指定し、詳細はComfyUI-Hunyuan3DWrapperを参照してください。

まず、現在のバージョンをアンインストールします：

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に関するエラーが発生した場合は、プラグインインストール部分で提供された解決策を参照して、対応する依存コンポーネントのインストールやコンパイルを行ってください。 対応するモデルはComfyUI/output/3Dフォルダに出力されます。これはHy3DExportMeshノードで設定された出力パスです。

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

3.1 ワークフローファイル

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

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

Hunyuan3D 2mvマルチビューモデルも同様に、Kijaiは初期変換バージョンを提供し、その後テンセントも対応するsafetensorsバージョンを提供しました。以下のいずれかのモデルをダウンロードしてComfyUI/models/diffusion_models/ディレクトリに保存できます。

💡

xatlasのインストール方法とプラグイン動作プリンシパルの違いにより、一部の画像ではテクスチャ出力でエラーが発生する場合があります。最良のテクスチャ生成のためにxatlasをうまく処理できるように、モデル生成前に入力画像の背景を削除すると役立ちます。

3.3 画像によるワークフローの実行

Hunyuan3DWrapper_multiview_1 Hunyuan3DWrapper_multiview_2

  1. Hy3DModelLoaderノードでhunyuan3d-dit-v2-mv-fp16.safetensorsがロードされていることを確認します
  2. Load Imageノードで異なる角度の入力画像をアップロードします。特定の角度の画像がない場合は、対応するノードを右クリックしてモードをNeverに設定します
  3. Queueボタンをクリックするか、ショートカット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の最新バージョンのワークフローテンプレートに追加されています。メニューバーのworkflow -> workflow templates -> 3dで見つけることができます。

ComfyUIネイティブワークフローテンプレート

💡

このセクションを始める前に、ComfyUIの最新バージョンにアップグレードしていることを確認してください。ComfyUIをアップデートするには、ComfyUIアップデートガイドを参照してください。

  • ComfyUI-Hunyuan3DWrapperと比較して、ネイティブワークフローは対応するモデルをComfyUI/models/checkpoints/ディレクトリに保存します。モデルは同じなので、以前にComfyUI-Hunyuan3DWrapperプラグインワークフローを使用していた場合は、モデル保存ディレクトリを適切に調整してください。
  • .glbファイルの出力場所はComfyUI/output/meshディレクトリで、SaveGLBノードで設定されています。

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関連リンク