Skip to main content
ComfyUI が最新版に更新されていることを確認してください。このガイドで紹介するワークフローは、ワークフローテンプレートから入手できます。 テンプレート内に該当のワークフローが見つからない場合、ComfyUI のバージョンが古くなっている可能性があります。ワークフローを読み込んだ際にノードが欠落している場合の考えられる原因:
  1. 最新の ComfyUI(Nightly 版)を使用していない
  2. 起動時に一部のノードのインポートに失敗している
SDPoseは全身のポーズ検出モデルで、画像や動画から人間のキーポイントを抽出します。RT-DETRv4物体検出器と組み合わせることで、複数人の検出やドメイン外 (OOD) のポーズ推定をサポートし、アニメーションパイプライン、ポーズ駆動型生成、モーショントラッキングのワークフローに適した多用途ツールです。 SDPose + RT-DETRv4 は ComfyUI にネイティブサポートされています (PR #12748)。モデルの重みは Hugging Face で入手可能です。 Hugging Face の SDPose モデル | RT-DETRv4 論文 (arXiv) | SDPose 論文 (arXiv)

主な強み

  • 全身キーポイント: 体、手、顔、足のキーポイントを1つの統合モデルで検出
  • 複数人対応: 1枚の画像や動画から複数人を検出し、ラベル付け
  • 設定可能な出力: 可視化する身体部位 (体、手、顔、足) を選択し、スティックやフォントサイズを制御可能
  • バウンディングボックス検出: 調整可能なしきい値とクラス選択による物体検出を含む
  • 画像と動画のサポート: 静止画、動画、OODポーズ推定向けの専用ワークフロー
制限事項: 検出精度は画像の解像度と被写体の視認性に依存します。極端に隠れている場合や非常に小さい被写体では、得られるキーポイントが少なくなることがあります。

SDPose ワークフロー

ユースケースに応じて、4つのワークフローが利用可能です。

1. ワークフローのダウンロード

ComfyUI を最新バージョンに更新してから、ワークフロー -> テンプレートを参照 に移動し、Utility カテゴリで SDPose ワークフローを見つけてください。

SDPose: 画像の複数人検出

画像をアップロードして人物のポーズを検出します。同じシーン内の単独の人物と複数の人物の両方の検出に対応しています。 SDPose 画像の複数人検出ワークフローのプレビュー

Comfy Cloud で実行

Comfy Cloud で開く

ワークフローをダウンロード

JSON をダウンロードするか、テンプレートライブラリで “SDPose: Image Multi-Person Detection” を検索してください
入力素材 このファイルを対応する LoadImage ノードにアップロードしてください:

group_photo.png

LoadImage ノード 679 · group_photo.png
入力画像

SDPose: ビデオ複数人検出

動画をアップロードして人のポーズを検出します。同じシーン内の単一の個人と複数人の両方の検出に対応しています。 SDPose ビデオ複数人検出ワークフローのプレビュー

Comfy Cloud で実行

Comfy Cloud で開く

ワークフローをダウンロード

JSON をダウンロードするか、テンプレートライブラリで “SDPose: ビデオ複数人検出” を検索してください
入力ファイル このファイルを対応する LoadVideo ノードにアップロードしてください:

man_playing_violin.mp4

LoadVideo ノード 694 · man_playing_violin.mp4

SDPose-OOD: 画像からポーズマップへ

画像をアップロードして、SDPose-OOD モデルでポーズのキーポイントを抽出し、対応するポーズマップを生成します。 SDPose-OOD 画像からポーズマップへのワークフロープレビュー

Comfy Cloud で実行

Comfy Cloud で開く

ワークフローをダウンロード

JSON をダウンロードするか、テンプレートライブラリで “SDPose-OOD: Image to Pose Map” を検索してください。
入力素材 このファイルを対応する LoadImage ノードにアップロードしてください。

dancer.png

LoadImage ノード 667 · dancer.png
出力例
入力画像SDPose-OOD 画像からポーズマップへの出力例

SDPose-OOD: ビデオからポーズマップへ

動画をアップロードしてポーズのキーポイントを抽出し、ポーズマップを生成します。このワークフローは複数人物の検出に対応しており、拡張されたSDPoseモデルを使用して全身の特徴を正確に抽出します。 SDPose-OODビデオからポーズマップへのワークフロープレビュー

Comfy Cloudで実行

Comfy Cloudで開く

ワークフローをダウンロード

JSONをダウンロードするか、テンプレートライブラリで「SDPose-OOD: Video to Pose Map」を検索してください
入力素材 対応するLoadVideoノードにこのファイルをアップロードします:

man_in_the_rain.mp4

LoadVideoノード679 · man_in_the_rain.mp4
出力例

2. モデルのダウンロード

SDPoseモデルとRT-DETRv4モデルのチェックポイントは、Comfy-Org SDPoseモデルリポジトリでホストされています。 checkpoints (SDPoseモデル): diffusion_models (RT-DETRv4検出器): 次のディレクトリ構造に配置してください:

3. ワークフローの使用

マルチパーソン(画像)

  • 入力: Load Image ノードを使用して画像を読み込みます。1人以上の人物が写った画像を使用します(例: group_photo.png)。
  • 検出: Image to Pose Map (SDPose Multi-Person) サブグラフが画像を処理し、以下を出力します:
    • IMAGE: 画像にオーバーレイ表示されたポーズスケルトンの可視化
    • keypoints: 全身の生のキーポイントデータ
    • bboxes: バウンディングボックス座標
  • 描画オプション: 描画する身体部位を設定します:
    • draw_bodydraw_handsdraw_facedraw_feet: 表示/非表示を切り替えます
    • stick_widthface_point_size: 表示スタイルを調整します
    • score_threshold: キーポイントを表示するための最小信頼度
  • 検出オプション:
    • resize_type.longer_size: 検出前に長辺をスケールします
    • max_detections: 検出する人物の最大数
    • detect_threshold: 検出の信頼度しきい値
    • detect_class: 検出するオブジェクトクラス(デフォルト: person)

マルチパーソン(ビデオ)

画像ワークフローと同じですが、ビデオフレームを順次処理します。Load Video を使用してビデオファイルを入力し、Save Video を使用して結果をエクスポートします。

OOD 画像からポーズへ

SDPose モデルを使用して、バウンディングボックスの可視化なしで画像からクリーンなポーズマップを生成します。これは、ある画像からスケルトンポーズを抽出して別の画像に適用したいスタイル転送に役立ちます。

OOD ビデオからポーズマップへ

ビデオからフレームごとのポーズマップを生成します。出力は、各フレームに抽出されたポーズスケルトンが含まれるビデオファイルで、後段のアニメーションやControlNetワークフローに適しています。

サブグラフについて学ぶ

これらのワークフローは、モジュール式処理のためにサブグラフノードを使用しています。サブグラフのドキュメントを参照して、ワークフローをカスタマイズおよび拡張する方法を学んでください。

補足情報

  • モデルディレクトリ: SDPoseチェックポイントは models/checkpoints/ に、RT-DETRv4検出器は models/diffusion_models/ に配置します
  • 入力画像の例: テスト用に、ワークフローテンプレートの input/ ディレクトリに group_photo.png ファイルが用意されています
  • キーポイント出力: POSE_KEYPOINTタイプは、条件付き生成のためにポーズデータを受け付ける下流ノードに接続できます
  • アップデート必須: SDPose + RT-DETRv4のサポートは最新版のComfyUIで利用可能です。ComfyUIが最新であることを確認してください