AI活用

ComfyUIのLazy Evaluation|選ばない分岐を実行しないノードの作り方

ComfyUIの分岐ノードで使わない入力まで計算される場合に、lazy入力とcheck_lazy_statusで必要な枝だけ要求する方法を解説。V1の小さな切替ノードを例にします。

この記事の目次
  1. if文だけでは上流の計算を省けない
  2. 二択のV1ノードを小さく作る
  3. 二度以上呼ばれても壊れない判定にする
  4. 別の出力から使われている枝は動く
  5. MuteやBypassを代わりに使うかを決める

二つの画像から一方を選ぶだけのノードでも、普通に入力を定義すると、選ばない画像の生成まで進むことがあります。実行関数の中のif文に到達する前に、上流の入力が評価されるためです。自作ノードならLazy Evaluationを使い、必要な入力だけを要求できます。

if文だけでは上流の計算を省けない

「下流でAを選ぶ」ことと「Bを作らない」ことは別です。たとえばAが既存の画像、Bが重い生成処理の場合、最後にAを返しても、それまでにBの生成を終えているかもしれません。

lazyにするのは選択候補の入力です。どちらを選ぶか決める条件まで遅延すると、必要な入力を判断できません。まず条件を評価し、その値から必要な枝を決めます。画面から部分的に試すPartial Executionと、自作ノード内部の要求制御を区別しましょう。

スポンサーリンク

二択のV1ノードを小さく作る

次の例は画像A・Bを受け取り、use_bで選ぶV1ノードです。両方の入力に接続した状態で使います。未接続を許可する例ではありません。

class PickImage:
    @classmethod
    def INPUT_TYPES(cls):
        return {"required": {
            "use_b": ("BOOLEAN", {"default": False}),
            "a": ("IMAGE", {"lazy": True}),
            "b": ("IMAGE", {"lazy": True}),
        }}

    RETURN_TYPES = ("IMAGE",)
    FUNCTION = "pick"
    CATEGORY = "devs_examples"

    def check_lazy_status(self, use_b, a=None, b=None):
        selected_name = "b" if use_b else "a"
        selected_value = b if use_b else a
        return [selected_name] if selected_value is None else []

    def pick(self, use_b, a=None, b=None):
        return (b if use_b else a,)

NODE_CLASS_MAPPINGS = {"DevsExamplePickImage": PickImage}

未評価のlazy入力はNoneとして渡されます。check_lazy_statusが返すのは画像そのものではなく、追加で必要な入力の名前です。必要な値がそろったら空のリストを返します。V1ではこのメソッドは通常のインスタンスメソッドです。

二度以上呼ばれても壊れない判定にする

必要な入力が段階的にそろうため、判定は複数回呼ばれ得ます。判定するたびにファイルを書いたり、別の生成を送信したりすると、重複処理を生みます。ここでは「何が足りないか」だけを返し、本処理は実行メソッドへ置きます。

選択値を途中でランダムに変える設計も避けます。一回目にAを要求し、次にBを要求するようでは、省くはずの処理が両方走ります。判断に使う条件を入力として固定し、その条件で必要な枝が一意に決まるようにします。

別の出力から使われている枝は動く

lazy入力を付けても、workflow全体でその枝が不要になるとは限りません。B側に別の保存ノードがつながっていて、その出力も実行対象なら、そちらからBが要求されます。

試験 確認する点
Aを選び、Bに他の出力がない Bの上流が要求されないか
Bを選ぶ 逆側でも同じ動作になるか
Bにも保存先を付ける 別出力からBが実行されることを説明できるか
AとBを続けて切り替える キャッシュと選択の両方が意図どおりか

ノードの色だけでなく、上流の実行ログでも確認します。最初から大きな画像生成を二つ使わず、小さな入力で分岐の働きを確かめてください。

MuteやBypassを代わりに使うかを決める

利用者が一時的に処理を外したいだけなら、MuteとBypassで十分な場面もあります。値によって自動で分岐を選ぶ再利用可能なノードを作りたいときに、lazyの実装が役立ちます。

2026年11月9日の公式のLazy Evaluation仕様をもとにしています。V3へ移す場合はcheck_lazy_statusがクラスメソッドになるため、V1のコードをそのまま混ぜず、使用中の仕様へ合わせてください。掲載例のComfyUI実機実行は未検証です。

スポンサーリンク