Beeble SwitchX: 비디오 편집은 당신이 설명한 것만 바꾸고 나머지는 그대로 유지할 수 있게 해주는 목적형 비디오 편집 워크플로입니다. 소스 비디오를 로드하고(선택적으로) 참조 이미지를 추가한 뒤, 새로운 환경과 조명을 설명하는 프롬프트를 입력합니다. 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
