ComfyUI のワークフローをネイティブ API から送信し、prompt_id を追跡する

目的と対象範囲

このガイドは、自分が所有する、または使用を許可されたインスタンスを対象とします。ComfyUI のネイティブ HTTP API は、このサイトのナレッジ MCP とは別のものであり、サードパーティーサービスへのアクセスを許可するものではありません。

出典から確認できること

公式ルートでは、POST /prompt の検証とキューへの登録について説明しており、prompt_id または構造化されたエラーを返します。実行メッセージと履歴を使って、受け付けられた後の処理を追跡できます。出典 1（英語） 出典 2（英語） 出典 3（英語）

始める前に

1. 現在のインスタンスで開いて実行できるワークフローを、API 形式でエクスポートして使います。

2. ローカルマシンと同じだと決めつけず、対象サーバーのノードとモデルを確認します。

3. 制限のない生成エンドポイントを公開せず、リモートアクセスを保護します。

手順と確認

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

手順 1. ネイティブ UI からエクスポートし、class_type と inputs を確認します。位置情報を持つ UI ノードは、API のプロンプト構造ではありません。

手順 2. サーバーで実際に選べる値を使って、必要な入力だけを置き換えます。元の ID と出力スロットは有効な状態に保ちます。

手順 3. 追跡可能な client_id とともに プロンプトを送信し、拒否されたレスポンスを無視せず、ステータス、エラー、node_errors を確認します。

手順 4. 受け付けられた prompt_id を保存し、WebSocket または履歴で成功、エラー、中断を追跡します。再試行のロジックでキュー項目が重複しないようにします。

コマンドとリクエスト例

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

const body = { prompt: API_WORKFLOW, client_id: CLIENT_ID };
const response = await fetch(`${COMFY_BASE_URL}/prompt`, {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify(body),
});
const result = await response.json();
if (!response.ok || !result.prompt_id) {
  throw new Error("Submission failed: inspect redacted error and node_errors");
}

完了の確認

検証が成功して ID が返され、対応する結果が最終的に取得できることを確認します。HTTP 200 やキュー番号を、生成済みの結果として表示しないでください。

制限と注意点

このコードはリクエスト形式の例であり、単体で実行できるグラフではありません。API_WORKFLOW、CLIENT_ID、COMFY_BASE_URL には実際の値が必要です。認証と上限時間を設けたネットワークタイムアウトは、デプロイ側で設定してください。

参照した原文資料

• ComfyUI Server API のルート（英語）（原文資料の確認日：2026-09-21）
• ComfyUI の実行メッセージ（英語）（原文資料の確認日：2026-09-21）
• ComfyUI の execution.py による検証（英語）（原文資料の確認日：2026-09-21）

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

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

• POST /prompt が 400 を返す：再試行する前に node_errors を確認する
• ノードに class_type がない：API エクスポートのエラーと登録漏れを区別する
• WebSocket は接続するのに結果が届かない：プロンプトごとの終了状態を追跡する
• タスク履歴と /view から ComfyUI API の出力を取得する