【2026年版】ComfyUIをAPIで動かす｜/promptの投げ方とエラーの読み方

同じワークフローで100枚まとめて生成したい。プロンプトだけ差し替えて回したい——そこまで来るとブラウザをクリックしている場合ではなくなる。ComfyUIはHTTPサーバとして動いているので、外からJSONを投げれば実行できる。ただし最初の一投目でほぼ全員がつまずく。画面から保存したワークフローJSONは、そのままでは受け付けてもらえないからだ。

ComfyUIはどこを叩けばいい？

ComfyUIは起動すると 127.0.0.1:8188 で待ち受ける（--listen と --port の既定値）。画面が使っているのと同じAPIを、そのまま外から呼べる。

このうち実際に叩いて確認したのは /prompt（POST・GET）、/history、/view、/object_info の5つで、/interrupt は生成の中断を伴うため試していない。

/object_info は自分の環境で何が使えるかを返す。検証環境では539種類のノードが並び、たとえば KSampler の必須入力が model, seed, steps, cfg, sampler_name, scheduler, positive, negative, latent_image, denoise であることまで読める。他人のワークフローが動かないときは、まずここに目的のノードが載っているかを見る。

いちばん多い失敗：ワークフローJSONをそのまま投げる

画面の「ワークフローを保存」で出てくるJSONと、APIが受け取るJSONは別物だ。実際に前者を投げると、こう返ってくる。

HTTP 400
{"error": {"type": "invalid_prompt",
           "message": "Cannot execute because a node is missing the class_type property.",
           "details": "Node ID '#id'"},
 "node_errors": {}}

APIが求めるのはノードIDをキーにした辞書で、各値が class_type と inputs を持つ形になる。画面用のJSONは構造からして違い、同梱テンプレート4本で確かめたところいずれも class_type を持つノードが0個で、4本とも同じ400が返った。メニューからAPI形式で書き出したものを使う。

{
  "prompt": {
    "1": {"class_type": "EmptyImage",
          "inputs": {"width": 64, "height": 64, "batch_size": 1, "color": 8421504}},
    "2": {"class_type": "SaveImage",
          "inputs": {"images": ["1", 0], "filename_prefix": "myrun"}}
  },
  "client_id": "my-client-001"
}

入力の ["1", 0] がノード1の0番目の出力を繋ぐという意味で、これが画面上の線に相当する。

ConoHa AI CanvasでComfyUI環境を用意する※ GPU不要・ブラウザだけで完結・環境構築の手間なし

最小の往復：投げて、待って、受け取る

上のJSONをPOSTすると、実測ではこう返る。

HTTP 200
{"prompt_id": "f2625144-0404-4b4b-8da3-25fa35dd5b9e", "number": 6, "node_errors": {}}

返ってくるのは受付番号であって、結果ではない。実行は非同期なので、prompt_id を持って結果を取りにいく。

GET /history/f2625144-0404-4b4b-8da3-25fa35dd5b9e

{"f2625144-...": {
   "status": {"status_str": "success", "completed": true},
   "outputs": {"2": {"images": [
       {"filename": "myrun_00001_.png", "subfolder": "", "type": "output"}]}}}}

outputs のキー "2" はSaveImageノードのIDだ。ここで得たファイル名を /view に渡せば画像そのものが返る——検証では GET /view?filename=myrun_00001_.png&subfolder=&type=output で image/png の64×64が取れた。ポーリングの間隔は、GET /prompt が返す {"exec_info": {"queue_remaining": 0}} を見て決めるのが素直だ。

エラーは node_errors を読む

内容の検証で弾かれたときは400で、error.type に理由の種別が入る。実測で確認できたのは次の4つだ。

4つのうち最後の1つだけ性質が違い、node_errors にノードIDごとの理由が入る。たとえばLATENTを画像入力に繋ぐと、こう返る。

"node_errors": {"2": {"errors": [{
    "type": "return_type_mismatch",
    "details": "images, received_type(LATENT) mismatch input_type(IMAGE)",
    "extra_info": {"input_name": "images", "received_type": "LATENT",
                   "linked_node": ["1", 0]}}]}}

どのノードの、どの入力が、何を受け取って落ちたかが全部入っている。自動化する側は error.message ではなく node_errors をログに残しておくと、あとで原因を追える。ComfyUIのコードにはこのほか required_input_missing、value_not_in_list、value_bigger_than_max、dependency_cycle といった種別も定義されている。

よくある質問

まとめ：詰まるのは形式のところだけ

形式さえ合ってしまえば、あとは inputs の値を書き換えて回すだけの作業になる。プロンプトの差し替えもシードの総当たりも、辞書を1か所いじるループで書ける。

ConoHa AI Canvasで“環境ごと固定”して運用する※ GPU不要・ブラウザだけで完結・環境構築の手間なし