ComfyUIで3Dモデルを生成する方法

本体・カスタムノード・重みを分けて理解する

ComfyUI本体はノードをつなぐ実行環境です。3D生成には、モデルを呼び出すカスタムノード、モデル重み、画像の入力、メッシュの出力などが必要になります。ワークフローのJSONだけを入れても、それが参照するノードや重みがなければ実行できません。

KijaiのラッパーはHunyuan3D-2向けのコミュニティ実装です。Hunyuan3D-2.1の公式READMEとは対象が異なるため、2.1のメモリ目安や導入コマンドをそのまま混ぜないでください。まずワークフローが使うモデル世代を固定します。

公開されている実在のワークフロー例を使う

参照リポジトリにはexample_workflowsディレクトリがあります。そこから必要な例を確認し、READMEの配置場所と導入手順を照合してください。画像にワークフローが埋め込まれている例もあるため、形式と読み込み方を確認します。

当サイトは存在しないノード名や、実行確認していない独自のワークフローを配布していません。公開例から始め、入力と形状生成の最小部分が動くことを確認してから、材質や追加処理を接続する順序を勧めます。

Pythonと拡張の互換性を合わせる

ラッパーのREADMEは依存関係のインストールと、Windowsの特定Python・CUDA向けビルドを説明しています。対象はPython 3.12などの具体的な構成であり、任意の環境でそのホイールが使えるわけではありません。Python、PyTorch、CUDA、OSが合うかを照合します。

ポータブル版では、そのポータブル版が使う埋め込みPythonに依存関係を入れる必要があります。ターミナルの別のPythonへインストールすると、ComfyUIからimportできない原因になります。パスが似ている場合も実行ファイルを確認してください。

材質生成の拡張はビルドが必要になることがあります。BPTなどの追加機能は別の重い要件を持つため、最初の導入に必須と考えず、基本の形状生成が動いた後で必要性を判断します。

モデルファイルを指定の場所へ置く

参照READMEは、変換済みsafetensorsモデルをComfyUI/models/diffusion_models/へ置く例を案内しています。残りのモデルに自動取得が含まれる場合もあるため、空きディスクと通信の条件を確認してください。重みの取得元とライセンスも記録します。

ファイルの拡張子を変えるだけで、別の世代や形式の重みが互換になるわけではありません。読み込めない場合は、ファイル名だけでなく、モデルの配布元、世代、容量、ダウンロードの完了を確認します。

• 重みとワークフローの世代を一致させる
• 指定されたディレクトリを使う
• モデルの取得元とライセンスを残す
• 初回の追加ダウンロードを確認する

ComfyUI/
  models/
    diffusion_models/
      <READMEが指定するモデルファイル>
  custom_nodes/
    ComfyUI-Hunyuan3DWrapper/

最小ワークフローから保存を確認する

権利を持つ単純な画像を使い、公開例の入力だけを置き換えて実行します。最初から複数のノードを更新・追加すると、不具合が起きた箇所が分からなくなります。形状生成と保存の成功を確認してから、材質生成などを追加します。

プレビューが表示されただけでなく、出力ファイルの場所と中身を確認します。別のビューアやBlenderで開き、形状、法線、材質、画像参照を見てください。形式は出力ノードと設定によるため、GLBやSTLが常に利用できるとは断定していません。

エラーは順に切り分ける

missing nodeならカスタムノードの導入・読み込みログ、model not foundなら配置と世代、importエラーなら実行Pythonと依存関係、メモリ不足なら形状と材質を分けて確認します。すべてのパッケージを一斉更新すると、動いていた環境まで変わるため避けてください。

共有するログには秘密情報や個人パスを必要以上に含めず、再現に必要な版、GPU、Python、PyTorch、ワークフローとエラーを残します。当サイトはこの構成を実行検証していないため、ここにある一般手順を動作保証として扱わないでください。