ComfyUIをPythonから実行する|公式SDKで生成画像を保存する方法
ComfyUIをPythonから動かすには、公式SDK「comfy-sdk」(Comfy API v2用、Beta 0.1.x)を使い、ローカルはcomfy-api-proxy経由で接続します。venvでの導入と接続確認、PromptとSeedの引数化、完了待ちと保存、複数実行のエラー処理、client層とmain処理の分離を解説します。
AIとつくる、実践プログラミング・コーディングメディア
CATEGORY
AI活用に関する基礎、実装例、トラブル解決の記事をまとめています。
ComfyUIをPythonから動かすには、公式SDK「comfy-sdk」(Comfy API v2用、Beta 0.1.x)を使い、ローカルはcomfy-api-proxy経由で接続します。venvでの導入と接続確認、PromptとSeedの引数化、完了待ちと保存、複数実行のエラー処理、client層とmain処理の分離を解説します。
Comfy MCPのローカル版はpip install comfy-mcpで入り、Claude CodeやCodexにstdioサーバーとして登録すると、Agentが手元のComfyUIのworkflowをToolとして実行できます。前提version、登録方法、固定workflowだけ許可する使い方、権限境界、beta追従の注意をまとめます。
ComfyUIのworkflowをGitで管理するなら、JSON・設定・依存の台帳だけをリポジトリに入れ、model本体と生成物は外に置きます。命名とフォルダ規約、modelのURL・hash・license台帳、custom nodeのmanifest、整形で差分を読みやすくする方法、検証条件の紐づけまで解説します。
Comfy CLIは公式のコマンドラインツールで、comfy run --workflow file.json --waitが自動化の基本形です。API・MCPとの使い分け、導入、1回実行、jqとループで組むBatch、CIでのSecret・Exit Code・Logの扱い、仕様変更への備えを解説します。
Comfy Cloud MCPの接続方法とローカル版との違いを解説。実行場所・認証・課金・保存場所の比較、APIキーを設定ファイルに直書きしない登録、最小jobでの確認、Secret管理、機密性とコストによる使い分けが分かります。
ComfyUI内で相談するComfy Agent、外部のAIアシスタントをつなぐComfy MCP、自作アプリから呼ぶHTTP APIを比較。画像を作る場所と、指示・実行を管理する場所を分けて選びます。
ローカルComfyUI向けcomfy-agentのプレリリースについて、対応環境、Pythonの確認、起動引数、導入前の退避と失敗時の戻し方を整理します。Desktopの正式対応や完全オフライン動作とは区別します。
ComfyUIのVAEは、画像とLatentを相互に変換する橋渡し役で、色味・明暗・細部の破綻に直接影響します。VAE EncodeとDecodeの位置、内蔵VAEと外部VAEの違い、同じLatentを2つのVAEでDecodeして比較する手順、不一致の症状の切り分けを解説します。
ComfyUIのImport Failedは本体の故障ではなく、特定のcustom nodeのPython importが失敗した状態です。起動logの「Import times for custom nodes」から対象を特定し、ModuleNotFoundErrorの読み方、Python実体の確認、nodeの一時無効化、再発防止までを順に示します。
ComfyUIのVRAM不足は、CUDA OOM・共有メモリ退避・遅さを区別し、nvidia-smiでPeakを記録してから、Batch・解像度・Model・Control系・Offloadを一つずつ切り分けると直せる範囲が分かります。記録表つき。
ComfyUIを画面以外から動かす経路は、ローカルのServer API、SDK付きのComfy API v2、Cloud APIの三つ。役割・認証・URLの違いを表で比べ、API形式JSONを/promptへ送ってPromptだけ差し替えて1枚生成する最小サンプルを示します。
ComfyUIのQueueは1件ずつ処理する列です。自アプリのJob IDとprompt_idの対応付け、状態遷移、/queueと/interruptで分けるキャンセル、原因別の再試行、ユーザー上限と429によるbackpressureの設計を解説します。
ComfyUIの生成速度は、workflow・model・commit・Driver・解像度・seedを固定し、初回Load(Cold)と2回目以降(Warm)を分け、起動ログの「Prompt executed in」秒数とnvidia-smiのPeak VRAMを同じ方法で記録すれば比較できます。CSVに残す記録設計まで解説します。
更新で壊れた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の注意、表示されないときの確認順を解説します。
Tool Callingを複数往復させるTypeScript実装。モデルとツールの回数上限、引数エラー、巨大な結果、usageの閾値を分け、APIキー不要の8テストで停止条件を確かめます。
プロンプトインジェクションの直接・間接攻撃と対策を開発者向けに解説。RAG・ツールの権限分離、入力検証、20件のテスト例を使い、拒否回答だけでなく実際の送信・保存結果まで確かめます。
AIエージェントの承認・停止・再開を設計する開発者向けに、承認対象の固定、未知操作の拒否、実行前の再検証を解説。停止後に残る外部処理と結果不明の扱い、境界を確かめるテストケースも整理します。
n8nとMCPの連携を、呼び出す側・workflowを公開する側・AIの選択に分けます。限定した読み取り、権限と引数、承認、再試行時の結果照合を整理します。
n8nの追加ノードを、標準ノード・HTTP Requestとの必要性から選びます。Verified、配布元、権限、対応版、試験、更新停止時の代替を整理する比較票です。
n8nのJSONとbinaryを区別し、ファイルの入力項目・サイズ・作業領域・保存先を確認します。CloudやDockerの実行場所、同名、複数添付、再保存の重複を整理します。
n8nでメール返信案を下書きへ保存し、宛先・CC/BCC・本文の版を確認してから送信する設計。未確定情報、同じ元メールへの重複、送信結果不明の照合を整理します。
n8nの変更を試験環境から本番へ渡す際の版・Credentials・送信先・公開状態を整理。固定データ、変更に対応する試験、戻す版と外部結果の区別を確認します。
n8nの実行データ・サーバーログ・外部結果記録を使い分けます。依頼IDによる追跡、debugの詳細度、秘密の除外、保管期間後の再送を点検する設計です。
WordPressでGA4・Search Console・Site Kitの役割を使い分けます。既存タグ、正しいプロパティ、二重計測、同意、検査アクセス、同条件の期間観測を確認する導入票です。
n8nで動画の文字起こし・要約をつなぐための素材と処理記録を整理。分割区間、原音確認、修正版、出力保管、外部共有の範囲をジョブ単位で管理する設計です。
元素材、生成条件、試行、編集、完成動画をIDでつなぐ保存方法を紹介。権利と同意、版、別コピー、更新・削除の対応を台帳へ残します。
WordPressの比較データを候補IDと項目で一元管理する設計。価格の単位・条件・確認日、表・詳細・schema・リンクの同期、未確認と期限切れの表示を点検します。
n8nで請求書を扱う際に、OCRの候補・原本照合・台帳登録を分ける設計。合計と小計、日付、通貨、番号、再送の重複を確認し、個別の税務判断は担当へ渡します。
WordPressとAIサイト制作サービスを、公開後の更新・フォーム・保守・移行で比較。生成画面を実原稿へ置き換え、総費用と書き出せる内容を試すための確認票です。