POST /prompt が 400 を返す：再試行する前に error と node_errors を確認する

症状と対象範囲

拒否されたリクエストは、構造化されたエラー情報を調べる必要があります。HTTP 400 だけではネットワークが不安定だとは判断できず、延々と再送信するべきではありません。

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

prompt_outputs_failed_validation
node_errors
HTTP 400

出典から確認できること

公式のルーティング資料では、prompt_id が正常に返される前に検証が行われると説明されています。バージョンを固定して参照したサーバールートでは、検証エラーの 400 に対してトップレベルの error と node_errors が返されますが、prompt ラッパーがない場合は node_errors が空になることがあります。ComfyUI 本体の検証でも、クラスや出力先がない場合はノードマップが空になり、一部の入力エラーでは内容が設定されたマップが返されます。まず error.type とその詳細を読み、存在する場合はノード単位の理由も確認してください。ルート（英語） サーバー（英語） 検証（英語）

区別すべき状況

1. トップレベルの prompt ラッパー、または API グラフの形式が正しくない。

2. モデルの計算が始まる前に、ノード、モデルの選択肢、リンク、数値の検証に失敗している。

3. ComfyUI の JSON ではなく、プロキシや別のサービスがエラーを返している。

確認手順

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

手順 1. どのサービスが応答したか確認するため、ステータス、Content-Type、機密情報を伏せたレスポンスを保存します。

手順 2. 最小限のネイティブ API エクスポートを送信し、グラフ変換の不具合とバックエンドの挙動を切り分けます。

手順 3. まずトップレベルの error.type、メッセージ、詳細を確認します。node_errors に errors 配列を含む項目があれば、対応するトラブルシューティングガイドを参照し、その各ノードの問題に一つずつ対処します。node_errors が空でも、拒否されたリクエストが有効だったことにはなりません。

手順 4. リクエストが受け付けられてから実行完了を待ちます。再試行できない検証エラーは、送信を繰り返すのではなく呼び出し元に返します。

完了の確認

想定したキューまたは履歴に有効な prompt_id が表示されることを確認します。最終的な成功の確認には、実行結果も必要です。

制限と注意点

履歴にはプロンプト、パス、traceback が含まれることがあります。公開する報告では機密情報を伏せ、コストが発生する可能性のあるタスクを黙って再実行しないでください。

参照した原文資料

• ComfyUI Server API ルート（英語）（確認日：2026-09-26）
• ComfyUI v0.37.0 の prompt ルート（英語）（確認日：2026-09-26）
• ComfyUI v0.37.0 の prompt 検証（英語）（確認日：2026-09-26）

出典とコードレビューを 2026-09-26 に更新しました。API 送信、GPU 実行、最低メモリ量の測定、実行時の保証は行っていません。

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

• ノードに class_type がない：API エクスポートのエラーと登録漏れを区別する
• Value not in list：ComfyUI の選択肢にモデルが表示されないとき
• Required input is missing：該当するノードと不足している入力欄を特定する