タスク履歴と /view から ComfyUI API の出力を取得する

目的と対象範囲

実行後、どのノードが結果を生成したか、結果がどこにあるかを特定します。ノード ID、prompt ID、ファイル名はそれぞれ異なる識別子です。

出典から確認できること

公式ルートは履歴と /view を公開しており、executed は UI 更新イベントです。出力構造は実際のノードによって異なり、どのノードにも共通する固定フィールドがあるわけではありません。出典 1（英語） 出典 2（英語）

始める前に

1. 受け付けられた prompt_id、対象インスタンス、許可されたアクセス方法を控えておきます。

2. 必要なデータを保存または返す出力ノードを使います。

3. ファイル名とサブフォルダーは、任意のユーザー指定の絶対パスではなく、サーバーのタスク応答から取得します。

手順と確認

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

手順 1. 処理の終了を待つか、その prompt_id の履歴を照会します。失敗した場合は、出力が空だからといってタスクが無期限にキューに残っていると解釈せず、エラーを報告します。

手順 2. 対応するノード種別について、実際の出力をたどります。固定の数値 ID が常に SaveImage に対応するとは限りません。

手順 3. /view リクエストでは、ファイル名、サブフォルダー、タイプを保持し、手作業で連結するのではなく URLSearchParams でエンコードします。

手順 4. 結果をタスクと関連付け、レスポンスの種類と長さを検証します。期限切れの一時ファイルについて説明し、上限を設けずにポーリングし続けないでください。

コマンドとリクエスト例

上記で特定した環境とシェルを使います。パスと変数は環境に合わせて変更する例です。これらのコマンドやスニペットは、お使いのマシンでは実行していません。

const query = new URLSearchParams({
  filename: item.filename,
  subfolder: item.subfolder ?? "",
  type: item.type ?? "output",
});
const fileUrl = `${COMFY_BASE_URL}/view?${query}`;

完了の確認

同時に複数のリクエストを実行している場合でも、クライアントが正しいタスクの成果物を、追跡可能な出力ノードとカテゴリとともに受け取ることを確認します。

制限と注意点

動画やカスタム出力スキーマには、明示的な処理が必要です。公開された連携機能で、パスパラメーターを通じた任意のサーバーファイル読み取りを許可しないでください。

参照した原文資料

• ComfyUI Server API のルート（英語）（原文資料の確認日：2026-09-21）
• ComfyUI の実行メッセージ（英語）（原文資料の確認日：2026-09-21）

翻訳準備日：2026-09-22。上記の資料確認日は既存の記事から引き継いだもので、この翻訳ですべてを本日再確認したとは主張しません。GPU での実行、最小メモリの測定、実行時の保証は提供していません。

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

• WebSocket は接続するのに結果が届かない：プロンプトごとの終了状態を追跡する
• キューがすぐ完了するのに新しいファイルがない：キャッシュと出力先を確認する