이 ComfyUI 튜토리얼은 SDPose-OOD: Video to Pose Map — 어떤 입력 비디오든 깔끔한 포즈 맵 시퀀스로 변환하는 워크플로를 안내합니다. 파이프라인은 LoadVideo로 프레임을 디코딩하고, 각 프레임을 SDPose-OOD 포즈 추출기(sdpose_wholebody_fp16.safetensors 체크포인트 기반)로 처리해 전신 키포인트를 감지한 다음, CreateVideo와 SaveVideo로 포즈 프레임을 최종 클립으로 조립합니다. SDPose-OOD 노드(type ID 01b6a731-fb78-4070-9a38-c87146da9604)는 다중 인물 감지를 지원하며, 몸/손/얼굴 랜드마크를 포함한 프레임별 렌더링 포즈 맵을 출력합니다.
기술적으로 SDPose-OOD 모델은 각 프레임에서 보이는 모든 인물에 대해 2D 키포인트를 추정하고, 노드는 그 랜드마크를 포즈 맵 이미지(스켈레톤/라인과 관절)로 렌더링해 시퀀스 전반에서 일관되게 만듭니다. LoadVideo의 원본 프레임 속도와 크기를 유지하면 CreateVideo가 소스 타이밍과 1:1로 정렬되는 포즈 비디오를 만들 수 있어, 하위 생성의 조건화(예: 포즈 가이드 이미지/비디오 합성)나 모션 분석, 프리비주얼라이제이션에 적합합니다. SaveVideo는 선택한 위치와 코덱으로 결과를 마무리합니다.
API
코드에서 이 워크플로우 사용하기
모든 Comfy 워크플로우는 JSON 그래프입니다. 아래 페이로드는 이 워크플로우 그 자체로, ComfyUI에서 실행되는 것과 동일합니다 — URL에서 가져오거나, 버전 관리에 보관하거나, ComfyUI에서 불러와 노드별로 실행할 수 있습니다.
Comfy SDK로 TypeScript 또는 Python에서 실행하세요. 동일한 코드는 Comfy Cloud 또는 직접 호스팅하는 ComfyUI 모두에 적용됩니다 — 기본 URL만 다릅니다.
// Install (beta)
npm i @comfyorg/sdk
// Run "SDPose-OOD: 비디오에서 포즈 맵으로" (TypeScript)
import { Comfy } from "@comfyorg/sdk";
const client = new Comfy({ apiKey: "comfyui-..." });
// This workflow, exported in API format (see note below)
const wf = await client.workflows.fromFile("utility_sdpose_ood_video_to_pose_map_api.json");
const job = await client.run(wf);
await job.getOutputs("680")[0].toFile("output.png"); // SaveVideoSDK는 API 형식의 워크플로우를 사용합니다: 이 워크플로우를 ComfyUI에서 열고 파일 → 워크플로우 내보내기(API)를 사용하세요.
FAQ
