ComfyUI APIの使い方|API v2・Cloud API・Server APIの違いから理解する
ComfyUIを画面以外から動かす経路は、ローカルのServer API、SDK付きのComfy API v2、Cloud APIの三つ。役割・認証・URLの違いを表で比べ、API形式JSONを/promptへ送ってPromptだけ差し替えて1枚生成する最小サンプルを示します。
AIとつくる、実践プログラミング・コーディングメディア
ARCHIVE
ComfyUIを画面以外から動かす経路は、ローカルのServer API、SDK付きのComfy API v2、Cloud APIの三つ。役割・認証・URLの違いを表で比べ、API形式JSONを/promptへ送ってPromptだけ差し替えて1枚生成する最小サンプルを示します。
ComfyUIのノード・ポート・リンク・Queueの見方、モデル配置、最小text-to-imageワークフロー、再現用設定、代表エラーを解説します。
ComfyUIのworkflow JSONや生成画像を読み込み、missing node・モデル不足を確認し、安全に再現・保存・共有する方法を解説します。
ComfyUIのQueueは1件ずつ処理する列です。自アプリのJob IDとprompt_idの対応付け、状態遷移、/queueと/interruptで分けるキャンセル、原因別の再試行、ユーザー上限と429によるbackpressureの設計を解説します。
公式Dockerイメージはなく、公式の手動インストール手順をDockerfileに写し、NVIDIA Container ToolkitでGPUを通し、models・output・custom_nodesをVolumeに出す構成が基本です。Python依存は分離できてもGPU DriverやVRAMはHost依存のままという境界まで扱います。
ComfyUIの生成速度は、workflow・model・commit・Driver・解像度・seedを固定し、初回Load(Cold)と2回目以降(Warm)を分け、起動ログの「Prompt executed in」秒数とnvidia-smiのPeak VRAMを同じ方法で記録すれば比較できます。CSVに残す記録設計まで解説します。
ComfyUIのworkflowをGitで管理するなら、JSON・設定・依存の台帳だけをリポジトリに入れ、model本体と生成物は外に置きます。命名とフォルダ規約、modelのURL・hash・license台帳、custom nodeのmanifest、整形で差分を読みやすくする方法、検証条件の紐づけまで解説します。
更新で壊れたComfyUIは、更新前に保存したSnapshotをRestoreして再起動すれば戻せます。本体・Frontend・Manager・Custom Nodeの4層の記録、Snapshotの作成と復元、最小Workflowでの確認、差分を1つずつ戻す手順を解説します。
ComfyUIのモデル保存先は、extra_model_paths.yamlにbase_pathと種類ごとのpathを書くだけで外部フォルダや他のUI(Forge・A1111)と共有できます。YAMLの書き方、Checkpoint・LoRA・VAEの分け方、外付けSSD・NASの注意、表示されないときの確認順を解説します。
ComfyUIをLAN外から使うときの防御設計を解説。--listenだけで公開しない理由、脅威モデル、リバースプロキシで入口を一つにする構成、Basic/OIDC/VPNの使い分け、入力制限、ログと更新の運用まで分かります。
Comfy Cloud MCPの接続方法とローカル版との違いを解説。実行場所・認証・課金・保存場所の比較、APIキーを設定ファイルに直書きしない登録、最小jobでの確認、Secret管理、機密性とコストによる使い分けが分かります。
ComfyUI Managerは現在ComfyUI本体に組み込まれ、Custom NodeはRegistryのversion単位で導入・更新します。新UIでの検索・導入・Missing Node特定・更新前確認・切り戻しの入口・安全なnodeの選び方を、2026年8月時点の名称で整理します。
n8nをオーケストレーター、Ollamaを解釈、ComfyUIを生成に分け、文章の依頼から画像生成までを自動化する構成を解説。Schema検証・Job IDの保存・Waitノードによる人の承認ゲート・途中からの再開まで、1件を却下から承認まで通す手順付き。
ComfyUIのVRAM不足は、CUDA OOM・共有メモリ退避・遅さを区別し、nvidia-smiでPeakを記録してから、Batch・解像度・Model・Control系・Offloadを一つずつ切り分けると直せる範囲が分かります。記録表つき。
ComfyUIの動画生成は、画像生成のworkflowに「時間軸(frame数)」と「Encode工程」が加わった構造です。T2VとI2Vの違い、Frames÷FPS=秒数の関係、VRAMと生成時間が何で決まるか、生成・補間・Upscale・Encodeを分ける理由を、特定modelに寄らない共通土台として解説します。
ComfyUIカスタムノードのCI/CDは、純Python部分のpytest、ComfyUI環境でのImport Smoke Test、Tagと連動したReleaseの3層で組み、公開は手動承認のGateを残す形が最小です。何を自動で確かめ、何を人が判断するかを分けて解説します。
Comfy Registryに自作カスタムノードを公開する手順を解説。Publisher IDとAPIキー、comfy node initで作るpyproject.tomlの必須フィールド、comfy node publishとGitHub Actionsの2経路、SemVerでの更新、eval/exec禁止などの安全基準まで公式仕様に沿って整理します。
ComfyUIカスタムノードにJavaScriptでボタンや表示を足す方法を解説。WEB_DIRECTORYの公開、app.registerExtensionのhook、Widget値がworkflow JSONに残る仕組み、Nodes 2.0での互換確認、UI例外からBackend処理を守る設計まで扱います。
ブランドやキャラクターのスタイルガイドをRAGで検索し、取得した規則をComfyUIのプロンプト設定フィールドに変換する手順を解説。Chunkの切り方、参照元IDを生成ログに残す方法、RAGでは解決しない画風再現の線引きまで扱います。
ComfyUIの生成画像をOllamaのVisionモデルで分析し、固定Schemaの評価JSONから限定的な再生成指示に変換する手順を解説。最大回数・改善閾値・人の承認で無限ループを防ぎ、VLMと人の判定のずれを測る記録表も用意します。
ローカルLLMで日本語の依頼を画像プロンプトにする方法を解説。翻訳ではなくSubject・Style・Lightingなどの項目化、JSON Schemaでの依頼、複数モデルを固定項目で比較する手順、長文の限界、生成前の検査まで分かります。
ReactでComfyUIの生成状況を表示する設計を解説。idle/queued/running/success/error/cancelledの6状態とuseReducerの遷移、WebSocketをHookに閉じ込める形、進捗率を捏造しない表示、Cancel・Retry、リロード後の復元まで分かります。
Next.jsのRoute Handlerを間に置き、ComfyUIの接続先とworkflowをサーバー側に閉じ込める3層構成を解説。zodによる入力検証、client層の分離、画像の中継、外部公開前の認証・レート制限・タイムアウトまで分かります。
Comfy CLIは公式のコマンドラインツールで、comfy run --workflow file.json --waitが自動化の基本形です。API・MCPとの使い分け、導入、1回実行、jqとループで組むBatch、CIでのSecret・Exit Code・Logの扱い、仕様変更への備えを解説します。
OllamaのStructured Outputsはformatにスキーマを渡し応答の形を保証しますが、値域や意味は保証しません。ComfyUI向けの最小Schema設計、受信後の再検証、ノードIDを隠すMapping層、Preset方式、自然文20件の検証手順を解説します。
OllamaのTool Callingでは、モデルはgenerate_imageを呼びたいと宣言するだけで、実行と検証はアプリが担います。最小のTool定義、tool_callsの受け取り、型・値域・列挙の検証、結果の戻し方、連続生成の防止をJavaScriptで解説します。
Open WebUIのチャットからComfyUIで画像を作るには、現行のToolsで固定workflowを呼ぶ関数を1つ作り、引数をprompt・size・seedに絞ります。Pipelinesとの違い、最小Toolのコード、引数検証、画像の返し方、第三者Toolの安全性を解説します。
ComfyUI APIで入力画像を渡すには、POST /upload/imageにmultipartで送り、返ってきたnameをAPI形式JSONのLoad Imageノードのimageに書き込んでから/promptへ投入します。アップロードの仕様、Node書き換え、img2imgとInpaintingのマスク連携、ファイル名の検証を解説します。
ComfyUIの生成進捗は、HTTPでjobを投入し、WebSocket(/ws?clientId=)でstatus・executing・progress・executedなどのイベントを受け取る二経路で取得します。接続とclientIdの対応、各イベントの読み方、UI stateへの変換、切断時の再確認、進捗率の見せ方を解説します。
ComfyUIをPythonから動かすには、公式SDK「comfy-sdk」(Comfy API v2用、Beta 0.1.x)を使い、ローカルはcomfy-api-proxy経由で接続します。venvでの導入と接続確認、PromptとSeedの引数化、完了待ちと保存、複数実行のエラー処理、client層とmain処理の分離を解説します。