Este fluxo de trabalho tutorial ComfyUI executa SDPose-OOD para detectar pessoas e suas poses corporais completas em uma imagem estática, com suporte embutido para cenas com múltiplas pessoas. O detector principal está empacotado em um subgrafo (id do tipo de nó 01b6a731-fb78-4070-9a38-c87146da9604) para manter o canvas limpo e ainda assim obter detecções rápidas e precisas. O pipeline começa com LoadImage, normaliza dimensões opcionalmente via ResizeImageMaskNode, e encaminha a imagem para o subgrafo SDPose. As pessoas detectadas são visualizadas com DrawBBoxes e sobrepostas na imagem original com ImageBlend para uma prévia legível e não destrutiva. Você pode inspecionar os resultados ao vivo com PreviewImage e exportá-los usando SaveImage.
O diferencial deste preset é a rapidez para ir de uma foto bruta a detecções claras de múltiplas pessoas com configuração mínima. Um nó PrimitiveInt expõe max_detections para controlar quantas pessoas são retornadas—útil para cenas lotadas. Internamente, o fluxo espera o checkpoint sdpose_wholebody_fp16.safetensors (veja Model Links) e pode ser combinado com a variante RT-DETR indicada no fluxo para localização robusta de pessoas. Se precisar de acesso mais profundo—como keypoints brutos, scores de confiança ou thresholds personalizados—clique com o direito no subgrafo para Unpack Subgraph e exponha as saídas internas necessárias.
API
Use este workflow a partir do código
Todo workflow Comfy é um grafo JSON. O payload abaixo é este workflow, exatamente como o ComfyUI executa — obtenha-o pela URL, mantenha-o no controle de versão ou carregue-o no ComfyUI e execute nó por nó.
Execute a partir de TypeScript ou Python com o Comfy SDK. O mesmo código serve para o Comfy Cloud ou um ComfyUI hospedado por você — apenas a URL base muda.
// Install (beta)
npm i @comfyorg/sdk
// Run "SDPose: Detecção de Múltiplas Pessoas em Imagens" (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"); // SaveImageO SDK utiliza um workflow no formato API: abra este workflow no ComfyUI e use Arquivo → Exportar Workflow (API).
O acesso à API do Comfy Cloud requer um plano com chave de API.
FAQ
