Este tutorial ComfyUI orienta você pelo SDPose-OOD: Vídeo para Mapa de Pose — um fluxo de trabalho que converte qualquer vídeo de entrada em uma sequência limpa de mapas de pose. O pipeline começa com LoadVideo para decodificar quadros, processa cada quadro pelo extrator de pose SDPose-OOD (usando o checkpoint sdpose_wholebody_fp16.safetensors) para detectar pontos-chave do corpo inteiro, e então monta os quadros de pose em um clipe final com CreateVideo e SaveVideo. O nó SDPose-OOD (ID do tipo 01b6a731-fb78-4070-9a38-c87146da9604) suporta detecção de múltiplas pessoas e gera um mapa de pose renderizado por quadro, cobrindo corpo, mãos e pontos faciais.
Tecnicamente, o modelo SDPose-OOD estima pontos-chave 2D para cada pessoa visível em cada quadro, depois o nó renderiza esses pontos como uma imagem de mapa de pose (esqueleto/linhas e juntas) consistente ao longo da sequência. Mantendo a taxa de quadros e dimensões originais do LoadVideo, o CreateVideo pode produzir um vídeo de pose alinhado um a um com o tempo de origem, tornando-o ideal como condicionamento para geração posterior (ex: síntese de imagem/vídeo guiada por pose) ou para análise de movimento e pré-visualização. O SaveVideo finaliza o resultado no local e codec escolhidos.
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-OOD: Vídeo para Mapa de Pose" (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"); // SaveVideoO 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
