メインコンテンツへスキップ
ComfyUI はデフォルトで HTTP サーバーとしてローカルで実行されます。ブラウザを開かずに、プログラムからワークフローの送信、ファイルのアップロード、出力のダウンロード、進捗の監視が可能です。

サーバーの起動

ComfyUI を起動すると、自動的に HTTP サーバーが http://127.0.0.1:8188 で起動します。 ヘッドレスモード(ブラウザを開かずに)で実行:
# ブラウザを開かずに実行
python main.py --disable-auto-launch
全起動オプションの一覧は python main.py --help を実行するか、起動オプションリファレンスを参照してください。

このセクションの主要ページ

起動オプション

main.py のすべてのコマンドライン起動オプションの完全リファレンス。

API ルート

ワークフロー送信、ファイルアップロード、ステータス確認用の HTTP エンドポイント。

API 例

API 呼び出しのコード例:HTTP のみ、WebSocket + History、SaveImageWebsocket。

サーバーメッセージ

実行中にサーバーからクライアントに送信される WebSocket メッセージタイプ。

実行モデル逆転

上級:カスタム制御フローのための実行逆転。

Partner Nodes の使用

ワークフローに有料 Partner Nodes が含まれている場合、ペイロードに API Key を含めることができます。詳細は Partner Node API 統合 ガイドを参照してください。

サーバーの仕組み

Comfy サーバーは aiohttp フレームワーク 上で動作しており、このフレームワークはさらに asyncio を使用しています。 サーバーからクライアントへのメッセージは、send_sync メソッド(server.py で定義された PromptServer のインスタンス)を通じてソケットメッセージとして送信されます。これらのメッセージは api.js に登録されたソケットイベントリスナーによって処理されます。詳細はメッセージを参照。 クライアントからサーバーへのメッセージは、api.js で定義された api.fetchApi() メソッドによって送信され、サーバーによって定義された HTTP ルートによって処理されます。詳細はルートを参照。
リクエストをキューに追加すると、クライアントはワークフロー全体(ウィジェット値などすべて)を送信します。キューに送信した後に加えた変更はサーバーに反映されません。実行中にサーバーの動作を変更したい場合は、ルートを使用してください。