AI活用

ComfyUIカスタムノードの入力検証|VALIDATE_INPUTSと実行時チェック

ComfyUIのVALIDATE_INPUTSで検査できる定数と、実行時に確認する接続先の値を区別。無条件のTrueやkwargsで標準検証を弱めないための実装例と試験表です。

この記事の目次
  1. 定数と接続から来る値を分ける
  2. 制限を自分で引き受けるなら、値も検査する
  3. 無条件のTrueで標準検証を消さない
  4. エラー文には直せる入力名を入れる
  5. V3へ移すときも検査の境界を残す

ComfyUIの自作ノードでは、入力欄へmin・maxを書くだけで、あらゆる入力を検査できるわけではありません。特にV1のVALIDATE_INPUTSを追加すると、引き受けた入力の標準検証を自分の処理で補う必要があります。定数を実行前に検査する段階と、上流ノードの結果を受け取る段階を分けて設計します。

定数と接続から来る値を分ける

ウィジェットへ直接入れた数値は、workflowの実行前に調べられます。別ノードが計算した画像や数値は、そのノードが動くまで実際の値がありません。VALIDATE_INPUTSに、まだ生成していない画像の縦横を検査させようとしても成立しません。

調べること 置く場所の例
固定値の選択肢・上下限 スキーマと実行前の検証
入力同士の組み合わせ 値がそろう段階の検証
生成された画像の形 実行メソッド
保存先へ実際に書けるか 実行時の処理と例外対応

同じルールを複数の場所へ手書きすると、片方だけ更新されることがあります。純粋な検査関数を一つ作り、必要な段階から呼び出す方法が使えます。

スポンサーリンク

制限を自分で引き受けるなら、値も検査する

例として、処理枚数を1〜8に制限する補助関数を考えます。これは自作アプリの設計例であり、ComfyUI全体の上限ではありません。

def validate_count(count):
    if isinstance(count, bool) or not isinstance(count, int):
        return "count must be an integer"
    if not 1 <= count <= 8:
        return "count must be between 1 and 8"
    return True

Pythonではboolがintの一種なので、ここでは真偽値を明示的に除外しています。V1のVALIDATE_INPUTS(cls, count)からこの関数を呼ぶなら、接続由来でまだcountが渡されないケースも考慮し、引数の既定値などを設計します。実行関数では実際に受け取ったcountへ同じ検査を行い、不正なら処理を始める前に止めます。

無条件のTrueで標準検証を消さない

公式仕様では、VALIDATE_INPUTSが明示的に受け取る入力は、そのメソッド側の検証へ委ねられます。そこで何も調べずTrueを返すと、画面の設定を見て期待していた制限がバックエンドで効かない原因になります。

また、**kwargsやinput_typesを受け取る定義は、標準検証へ影響する範囲が広がります。「引数エラーを消したい」という理由だけで追加せず、自分で引き受ける検証を先に列挙してください。標準の型・範囲検証で足りるなら、追加メソッドを作らない選択もあります。

エラー文には直せる入力名を入れる

「invalid input」だけでは、利用者はどの欄を戻すべきか分かりません。入力名と期待範囲を示すと、修正の手がかりになります。ファイル内容や認証情報までエラーへ含める必要はありません。

上の例なら、1・8が通ることに加え、0・9・小数・文字列・真偽値が通らないことを確認します。GUIだけでなくAPI形式のworkflowからも試し、ウィジェットの操作制限に依存していないかを見ます。重い処理の前に止まることも、試験の一部です。

V3へ移すときも検査の境界を残す

V3では対応するメソッド名がvalidate_inputsになります。名前を置き換える前に、どの値をいつ検査していたかを試験として残します。移行して画面が開くことと、不正入力を拒否できることは別の確認です。

2026年11月9日に公式の入力検証仕様を確認しました。最初は最も重い処理の一歩手前へ検査を置き、正常・境界・異常の三群で試しましょう。純Python部分を自動で確認する方法はカスタムノードのCI/CDで扱っています。

スポンサーリンク