Beeble SwitchX: Video Edit は、説明した部分だけを変更し、それ以外は維持することに特化した動画編集ワークフローです。ソース動画と（任意で）参照画像を読み込み、新しい環境とライティングを説明するプロンプトを入力します。BeebleSwitchXVideoEdit ノードが Beeble SwitchX の動画編集モデルを適用し、マスク領域はプロンプトと参照に従って生成しつつ、マスク外は元のピクセルと動きを保持した編集クリップを出力します。さらにアルファマットも生成されるため、任意の NLE で編集領域を未変更のソースに合成できます。
技術的には、グラフは LoadVideo でクリップをデコードし、GetVideoComponents でサイズとフレーム数を抽出します。「Get frame counts (need < 240)」グループはモデル推奨のフレーム上限内に収めるのに役立ちます。クリップが長すぎる場合は Video Slice で扱いやすい範囲にトリミングします。LoadImage で任意のルック参照を読み込み、GetImageSize でサイズ整合を考慮します。BeebleSwitchXVideoEdit は時間的一貫性を保ちながらフレームを処理し、編集済み動画とフレームごとのアルファマットを出力します。PreviewAny で中間結果を確認し、SaveVideo で最終編集をレンダーします。元の動きを壊さずに、リライト、環境置換、特定オブジェクトのスタイライズを行える実用的な非破壊手法です。
API
このワークフローをコードから利用
すべてのComfyワークフローはJSONグラフです。以下のペイロードは、このワークフローそのものであり、ComfyUIが実行する内容と同じです — このURLから取得し、バージョン管理に保存したり、ComfyUIで読み込んでノードごとに実行できます。
Comfy SDKを使ってTypeScriptまたはPythonから実行できます。同じコードでComfy Cloudや自身でホストしたComfyUIのどちらにも対応 — ベースURLだけが異なります。
// Install (beta)
npm i @comfyorg/sdk
// Run this workflow (TypeScript)
import { Comfy } from "@comfyorg/sdk";
const client = new Comfy({ apiKey: "comfyui-..." });
const wf = await client.workflows.fromFile("workflow_api.json");
const job = await client.run(wf);
await job.getOutputs("<output-node-id>")[0].toFile("output.png");SDKはAPI形式のワークフローを受け取ります：このワークフローをComfyUIで開き、「ファイル → ワークフローをエクスポート（API）」を使用してください。
FAQ
