RLR-0031 ・ 更新 2026/10/20
ComfyUIのSubgraph Blueprint入門｜長いノードを部品化して再利用する方法
ComfyUIのSubgraphとSubgraph Blueprintを使えば、複数ノードをひとつにまとめてNode Libraryから再利用できます。公式手順、frontendの必要バージョン、独立編集の仕組み、つまずきやすい点を初心者向けに解説。
ComfyUIで画像や動画を作り込むほど、画面がノードと線でいっぱいになりませんか？
「この前処理、別のワークフローでも毎回組んでいる」「よく使うノードの組み合わせを保存して、必要なときだけ呼び出したい」。そんなときに役立つのが、**Subgraph（サブグラフ）とSubgraph Blueprint（サブグラフ・ブループリント）**です。
結論からいうと、Subgraphは複数ノードをひとつの部品にまとめる機能。さらにBlueprintとしてNode Libraryへ登録すると、次回からその部品を普通のノードのように検索・追加できます。公式ドキュメントで手順が公開されており、専用のカスタムノードを自作する必要はありません。
ただし重要な条件があります。Subgraphの利用にはComfyUI frontend 1.24.3以降、BlueprintとしてNode Libraryへ登録するにはfrontend 1.27.7以降が必要です。ここでいう「frontend」は画面側のバージョンであり、ComfyUI本体の「v0.42.1」などの数字と混同しないでください。
この記事は2026年10月20日時点のComfyUI公式Subgraphガイドを確認してまとめた操作ガイドです。新モデルの発表記事ではなく、日々の制作を整理するための長く使えるHOWTOです。筆者の実機操作は未検証のため、画面表示や操作の細部は利用環境で異なる場合があります。
まず「Group」「Subgraph」「Blueprint」は何が違う？
名前が似ていても、使う目的は違います。
| 仕組み | 何をする？ | 向いている場面 |
|---|---|---|
| ノードを見やすく整理する | キャンバス上の配置を整理する | 同じ画面の視認性を上げたい |
| Subgraph | 複数ノードを、入出力を持つひとつのノードとしてまとめる | 長い処理を部品にして見通しを良くしたい |
| Subgraph Blueprint | 作ったSubgraphをNode Libraryに登録する | よく使う部品を、別の場所でも呼び出したい |
たとえば、画像生成ワークフローの中に「画像サイズの調整 → 必要な前処理 → 出力」のような繰り返し使う処理があるとします。
Subgraphにまとめれば、親の画面では**「前処理セット」という1個のノード**のように見せられます。内部の複数ノードは消えず、あとから編集できます。さらにBlueprintに登録すれば、次の制作でそのまとまりをNode Libraryから追加できます。
これは画像生成モデルを新しく追加する機能ではありません。ノードの組み方を整理・再利用するための仕組みです。
使えるかどうかは「frontendのバージョン」で確認
公式ガイドの要件は次のとおりです。
| やりたいこと | 公式が示す条件 |
|---|---|
| Subgraphを作成・編集する | frontend 1.24.3以降 |
| SubgraphをBlueprintとしてNode Libraryに登録する | frontend 1.27.7以降 |
| Subgraphのパラメーターを専用パネルから編集する | ComfyUI本体 v0.3.66以降（公式ガイド記載） |
ComfyUI本体とfrontendは別のバージョン体系です。「本体を更新したから必ずBlueprintボタンがある」とは判断せず、実際の画面とfrontendのバージョンを確認してください。Desktop、Portable、手動導入では更新経路も異なります。
古い画面に機能が見当たらない場合は、まず公式Subgraphガイドから更新案内を確認しましょう。制作中のワークフローを壊さないよう、更新や編集の前に元のワークフローを別名で保存しておくのがおすすめです。
手順1：まとめたいノードを選び、Subgraphにする
公式が案内する基本操作はシンプルです。
- ComfyUIで既存のワークフローを開き、ひとまとめにしたい複数ノードを選択します。
- 選択時に表示されるツールバーのSubgraphアイコンをクリックします。
- 選んだノードが、ひとつのSubgraphノードにまとめられます。
- 親のワークフローから見て分かりやすい名前を付け、接続を確認します。
最初は画像生成全体を丸ごとまとめるより、毎回使う小さな処理のかたまりから試すと、どこが入力でどこが出力なのか把握しやすくなります。
たとえば「画像のリサイズ」「共通の前処理」「出力直前の整形」などです。これは使い方の例であり、特定のノード構成で動作を実測した結果ではありません。
手順2：内部へ入り、入力と出力を整える
Subgraphは箱に入れて終わりではありません。外側から操作したい入力・出力をどう見せるかが使いやすさを決めます。
公式ガイドでは、Subgraph内部へ入る方法として次の2つを案内しています。
- Subgraph内のウィジェットではない空白部分をダブルクリックする
- Subgraphの編集ボタンを押す
内部の編集画面には、親ワークフローにつながる入力・出力のスロットが表示されます。必要な内部ノードをそこへ接続し、外部に公開する入出力を整理します。スロットを右クリックして名前を変更したり、不要な接続を外したりすることもできます。
たとえば外側のノードから画像を受け取るなら、入力側に「画像入力」、処理後に次のノードへ渡すなら出力側に「処理済み画像」といった意味が分かる名前を付けると、再利用時に迷いにくくなります。
データ型の整合性は通常のノード接続と同じです。画像（IMAGE）を期待する場所へ別の型をつなげるなど、無理な接続はできません。見た目だけをまとめても、入出力の設計が曖昧だと使いにくい部品になります。
編集画面から親へ戻るときは、上部のナビゲーションバーかEscキーを使います。Subgraphを入れ子にすることも可能ですが、最初から何段も重ねず、1段で動きを理解するのが安全です。
手順3：Node Libraryに「Blueprint」として登録する
ここが今回の本題です。
frontend 1.27.7以降なら、作成したSubgraphをNode Libraryに登録できます。公式ガイドでは、Subgraphを選んだときのツールボックスから次のどちらかを使います。
- 本（publish）のアイコンをクリックする
- ツールボックスのメニューからAdd Subgraph to Libraryを選ぶ
登録用のダイアログが表示されたら名前を確認します。初期状態ではSubgraphノードの名前が使われます。意味のある名前を付けて登録すると、Node LibraryのSubgraph Blueprintsから呼び出せるようになります。
次のワークフローでは、Node Libraryで名前を検索するか、一覧からドラッグして追加します。つまり、毎回同じノードを探して配線する代わりに、あらかじめ作った処理のセットを1個のノードとして配置できます。
ただし、公式が明記しているのはNode Libraryへの登録と再利用です。登録したBlueprintが別PCへ自動同期される、クラウドへ保存される、すべての環境へ自動移行できる、といったことまで保証する資料ではありません。別のPCや人と共有する場合は、保存・移行の方法と依存ノードを別途確認してください。
Blueprintから追加したノードは、元と自動同期する？
ここは特に間違えやすいポイントです。
公式ガイドによると、Blueprintからワークフローへ追加したSubgraphは、それぞれ独立した個体です。追加後に片方を編集しても、別の個体へ自動反映される仕組みではありません。
つまり、Blueprintは「同じ部品を呼び出すためのひな形」と考えるのが分かりやすいでしょう。
| 操作 | どう考える？ |
|---|---|
| BlueprintをNode Libraryへ登録 | 再利用するための元となるひな形を保存 |
| Blueprintから新しいSubgraphを追加 | 独立したコピーを作る |
| 追加済みのSubgraphを編集 | その個体を変更する |
| 元のBlueprintを編集・保存 | 今後使うひな形を更新する。ただし既存の個体が一斉更新されるとは考えない |
Blueprint自体を編集する場合は、Node Library側の編集ボタンから編集モードへ入り、公式ガイドにある保存ボタンまたはCtrl + Sで更新します。すでに使っている別個体へ変更を反映したい場合は、個別に内容を確認してください。
「ひな形を直したら過去のすべてのワークフローが書き換わる」という挙動ではないことは、むしろ既存制作を守る上で重要な特徴です。
画像・動画生成では、何を部品化すると便利？
まずは繰り返し使うが、作品ごとに少し調整する処理を候補にすると便利です。
画像生成の場合： 画像サイズの整形や、複数ノードで構成する共通の前処理をまとめると、メインのキャンバスを見やすくできます。
動画生成の場合： フレームの前処理や、毎回同じ流れで使う入出力の変換部分をまとめると、長い動画用ワークフローの見通しを改善できます。
複数のモデルを使い分ける場合： 共通化できる部分だけをBlueprintにし、モデル固有の設定や必要なノードは外に残すと、どこを変えればよいか分かりやすくなります。
ただし、Blueprint化すれば生成速度が上がる、VRAM使用量が減る、欠けているカスタムノードを補えるわけではありません。主な効果はワークフローの整理と再利用です。実際の処理時間やメモリ量はモデル・ノード・実行条件によって変わります。
「必要な枝だけ実行したい」なら別機能を使う
Subgraphと混同しやすいのが、ComfyUIの**Partial Execution（部分実行）**です。
Subgraphはノードを部品化する機能。Partial Executionは、選んだ出力ノードに必要な経路だけを実行する機能です。
公式のPartial Executionガイドでは、PreviewやSaveなどの出力ノードを選択し、選択ツールボックスに表示される青い三角アイコンを押す方法が紹介されています。出力ノード以外では使えません。古いfrontendでは全体が動いてしまう既知の問題があるため、表示や挙動が異なるときは更新状態を確認してください。
「ワークフローをすっきり整理したい」ならSubgraph、「途中の枝だけ試したい」ならPartial Execution。両方を知っておくと、目的に合う操作を選びやすくなります。
よくあるつまずきと確認ポイント
Q. Subgraphは作れるのに、Node Libraryへ登録するボタンがない。
A. Subgraph自体はfrontend 1.24.3以降で使えますが、Blueprintへの登録には1.27.7以降が必要です。まずfrontend側のバージョンを確認してください。ツールボックスの表示も公式画像と違う場合があります。
Q. まとめたら配線がうまくつながらない。
A. 内部の入力・出力スロットとデータ型を確認してください。見た目をまとめる操作と、外から使いやすい入出力に整える操作は別です。元のワークフローを残し、コピーで少しずつ試すと切り分けやすくなります。
Q. ひな形を修正したのに、前に追加したSubgraphが変わらない。
A. 公式仕様では追加された個体は独立しています。自動同期を前提にせず、既存個体の修正が必要かを確認してください。
Q. Blueprintを作ったらGPUの負荷は減る？
A. 負荷軽減は保証されません。 ノードの見通しを良くする機能です。VRAMや速度を改善したい場合は、モデル、解像度、バッチ数、実行する枝などを別に検討しましょう。
Q. 別のPCや仲間にBlueprintを渡せる？
A. 公式ガイドから確認できるのはNode Libraryでの登録・呼び出しです。PC間の自動同期や配布形式については、本記事では確認できていません。共有の際は環境差とカスタムノードの依存関係に注意してください。
まとめ：長いワークフローを「使い回せる道具箱」に
ComfyUIのSubgraph Blueprintを覚えると、画像・動画生成で繰り返し使う処理を自分用の道具箱に整理できます。
- Subgraph： 複数ノードをひとつの部品へまとめる。frontend 1.24.3以降。
- Subgraph Blueprint： その部品をNode Libraryへ登録して再利用する。frontend 1.27.7以降。
- 追加した個体： それぞれ独立して編集でき、元のひな形と自動同期しない。
- 注意： GPUの高速化やVRAM節約を約束する機能ではない。
まずは壊しても困らないワークフローのコピーで、2〜3個のノードをまとめるところから試してみてください。「毎回同じノードを並べ直す」時間を減らす第一歩になります。
参考にした一次情報
※本記事は2026年10月20日時点の公式資料を確認した解説です。実機での操作・速度・VRAM検証は行っていません。画面や仕様は更新される可能性があります。
SOURCES