이 ComfyUI 튜토리얼 워크플로는 SDPose-OOD를 실행해 스틸 이미지에서 사람 및 전신 포즈를 감지하며, 다인 장면을 기본 지원합니다. 코어 디텍터는 서브그래프(노드 유형 id 01b6a731-fb78-4070-9a38-c87146da9604) 안에 패키징되어 있어, 상위 캔버스는 깔끔하게 유지하면서도 빠르고 정확한 감지를 얻을 수 있습니다. 파이프라인은 LoadImage로 시작해, 필요하면 ResizeImageMaskNode로 크기를 정규화한 뒤, 이미지를 SDPose 서브그래프로 전달합니다. 감지된 사람은 DrawBBoxes로 시각화되고 ImageBlend로 원본 이미지 위에 오버레이되어, 읽기 쉬운 비파괴 미리보기를 제공합니다. PreviewImage로 라이브 확인이 가능하며 SaveImage로 내보낼 수 있습니다.
이 프리셋의 장점은 최소한의 설정으로 원본 사진에서 명확한 다인 포즈 감지 결과까지 매우 빠르게 도달할 수 있다는 점입니다. PrimitiveInt 노드로 max_detections를 노출해 반환할 사람 수를 제어할 수 있어, 혼잡한 장면에서 유용합니다. 내부적으로 이 워크플로는 sdpose_wholebody_fp16.safetensors 체크포인트(모델 링크 참고)를 기대하며, 워크플로에 표시된 RT-DETR 변형과 함께 사용해 사람 위치 추정의 견고함을 높일 수 있습니다. 키포인트, 신뢰도 점수, 커스텀 임곗값 같은 더 깊은 접근이 필요하면, 서브그래프를 우클릭해 Unpack Subgraph를 선택하고 필요한 내부 출력들을 연결해 사용하세요.
API
코드에서 이 워크플로우 사용하기
모든 Comfy 워크플로우는 JSON 그래프입니다. 아래 페이로드는 이 워크플로우 그 자체로, ComfyUI에서 실행되는 것과 동일합니다 — URL에서 가져오거나, 버전 관리에 보관하거나, ComfyUI에서 불러와 노드별로 실행할 수 있습니다.
Comfy SDK로 TypeScript 또는 Python에서 실행하세요. 동일한 코드는 Comfy Cloud 또는 직접 호스팅하는 ComfyUI 모두에 적용됩니다 — 기본 URL만 다릅니다.
// Install (beta)
npm i @comfyorg/sdk
// Run "SDPose: 이미지 다중 인물 감지" (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_multi_person_api.json");
const asset = client.assets.fromFile("input.png");
wf.setInput("679", "image", asset); // LoadImage
const job = await client.run(wf);
await job.getOutputs("680")[0].toFile("output.png"); // SaveImageSDK는 API 형식의 워크플로우를 사용합니다: 이 워크플로우를 ComfyUI에서 열고 파일 → 워크플로우 내보내기(API)를 사용하세요.
FAQ
