二つの画像から一方を選ぶだけのノードでも、普通に入力を定義すると、選ばない画像の生成まで進むことがあります。実行関数の中の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実機実行は未検証です。