数値入力の検証に失敗する：ノードの実際の型と範囲を使う

症状と対象範囲

変換の失敗と、現在のノードの範囲外の値では、確認すべき点が異なります。ノードのコードを変更したり数値を切り詰めたりする前に、送信した値を確認します。

検索の手掛かりとなるエラーの断片です。ID、値、ファイル名は環境によって変わります。

invalid_input_type
value_smaller_than_min
value_bigger_than_max

出典から確認できること

ComfyUI 本体の検証では、該当する最小値・最大値の確認より前に、リテラルの INT、FLOAT、STRING、BOOLEAN 入力を変換します。カスタムノードのバリデーターが入力欄の検証を引き継ぎ、別のルールを適用する場合もあります。BOOLEAN では ComfyUI 本体が Python の bool(value) を使うため、"false" のような空でない文字列は true になります。実際の JSON の真偽値を送信してください。数値に見えるフォーム入力でも、送信値が有効だとは限りません。出典 1（英語）

区別すべき状況

1. API が、想定される値の代わりに空文字列、単位付きのテキスト、またはロケール形式の数値を送信している。

2. コピーしたワークフローが、別バージョンのノードで設定された範囲に依存している。

3. フロントエンドの想定が、バックエンドの定義またはカスタムバリデーターと異なる。

確認手順

以下は引用した資料に基づく編集上の手順です。あなたの環境で原因が確定したことを意味しません。

手順 1. node_errors を読み、エラーの種類、input_name、存在する場合は received_value、元の送信 JSON 値と型を記録します。変更を加える前に、ワークフローのコピーを手元に保存します。

手順 2. 現在のノードの入力定義と送信値を比較します。invalid_input_type の場合は INT または FLOAT への変換を確認します。value_smaller_than_min または value_bigger_than_max の場合は、その入力欄に現在設定されている範囲を確認します。カスタムバリデーターのエラーでは、そのノード独自のルールを確認します。

手順 3. コピーしたリクエストで、意図した値と現在のノードの仕様に合う、曖昧さのない JSON の数値または真偽値を送信します。数値に見える文字列や "false" が、型変換後も意図した意味を保つと思い込まないでください。

手順 4. 入力欄の意味を確認してから一括修正を行います。値を無差別に切り詰めて検証を通すと、タスクの内容が変わる場合があります。

完了の確認

該当する検証エラーが消え、送信した値の意味が保たれ、変更後も元のタスクが想定どおりに動作することを確認します。

制限と注意点

デフォルト値は出発点であり、あらゆる状況で最適な設定とは限りません。バージョン固有の上限値を記録し、恒久的な数値一覧として公開しないでください。

参照した原文資料

• ComfyUI execution.py の検証（英語）（出典の再確認日：2026-09-27）

ソースの確認と英語原文の独立した編集チェック：2026-09-27。ローカル API への送信、ワークフローの実行、GPU での実行は行っていません。

関連するトラブルシューティング記事とガイド

• POST /prompt が 400 を返す：再試行する前に node_errors を確認する
• Required input is missing：該当するノードと不足している入力欄を特定する