이 ComfyUI 튜토리얼은 Wan3.0-Video 모델로 구동되는 컴팩트한 텍스트에서 비디오로 파이프라인을 안내합니다. 워크플로의 핵심은 Wan3ReferenceToVideoApi 노드로, 프롬프트(및 선택적 참조 이미지)를 Wan3.0-Video 서비스로 전송한 뒤 렌더링된 단일 클립을 반환합니다. SaveVideo 노드는 해당 클립을 디스크에 기록합니다. API 노드에서 재생 시간(최대 30초), 해상도/비율, 프레임 속도, 시드 및 기타 생성 설정을 직접 제어할 수 있어, 하나의 그래프에서 반복 작업이 쉽습니다.
기술적으로 Wan3ReferenceToVideoApi는 원격 작업 라이프사이클을 처리합니다. 텍스트 프롬프트와 참조 입력을 패키징해 요청을 제출하고, 완료될 때까지 폴링한 뒤 완성된 비디오를 출력합니다. “Reference” 기능은 얼굴 또는 캐릭터 이미지를 제공할 때 캐릭터/스타일 일관성을 유지하는 데 도움이 됩니다. API 플랜/모델이 지원한다면 동기화된 사운드를 함께 반환할 수 있으며, 지원하지 않으면 나중에 후반 작업에서 사운드를 넣을 수 있는 무음 비디오를 받게 됩니다. SaveVideo는 선택한 파일 이름 패턴과 fps로 출력을 마무리해, 텍스트에서 제작용 영상으로 가는 단순하고 안정적인 경로를 제공합니다.
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
