← 返回列表

ComfyUI-SAM3DBody_utills-README.md

ComfyUI-SAM3DBody_utills

Language: 🇯🇵 日本語 (current) ・ 🇬🇧 English

PozzettiAndrea/ComfyUI-SAM3DBody をベースにした、「1 枚の画像からリグ付き 3D キャラクターを作る」 ことに焦点を絞った utility fork。

✏ へたくそな落書きを、ポーズリファレンスに変える

sample4

左から順に: ① 仕上げたいキャラクター ・ ② 手描きの雑なラフ ・ ③ 本プラグインが出力する 3D 素体 (ラフから抽出したポーズをキャラクター体形に当てはめたもの) ・ ④ ③ を画像編集モデルに通した最終出力。

絵心がなくてもポーズさえ伝わればよく、棒人間レベルの落書き → 正しいプロポーションと 3D 的整合性を持ったポーズ参照画像 に変換できるのが本プラグインの狙いです。得られた ③ を img2img / Qwen-Image-Edit などに食わせれば、④ のような仕上げ画像まで一気通貫で到達できます。

このプラグインでできること

1. 入力画像のポーズを、任意の体形の 3D モデルでレンダリング

入力したキャラクター画像からポーズだけを抽出し、自分で設定した体形 (身長・太さ・顔の形・骨の長さ…) の 3D 素体に当てはめてレンダリングします。

sample1

2. リギング済みアニメーション FBX / BVH として書き出し

同じポーズ + 体形のキャラクターを、アーマチュア + スキニング済みメッシュ + ポーズアニメを含む FBX として <ComfyUI>/output/ に出力できます。FBXはそのまま Blender / Unity / Unreal Engine で読み込めます。BVHはCLIP STUDIO PAINTで読み込めるのを確認

sample2

3. 動画からモーションキャプチャ付き FBX / BVHを書き出し

ComfyUI-VideoHelperSuite で読み込んだ動画を各フレームごとに SAM 3D Body に通し、基本姿勢でリグ付けされたキャラクターに連続モーションをベイクしたアニメーション FBX として <ComfyUI>/output/ に書き出します。Unity にドロップすれば、そのまま Animator / Timeline で再生できるモーションクリップになります。BVHはCLIP STUDIO PAINTで読み込めるのを確認。

<!-- DEMO_VIDEO_START --> https://github.com/user-attachments/assets/4fa43a56-8dd2-4ebf-8abe-61a31ff14e6f <!-- DEMO_VIDEO_END -->

含まれるノード (11 個)

モデル / 推論

  1. Load SAM 3D Body Model — <ComfyUI>/models/sam3dbody/ からモデル重みを遅延ロード
  2. SAM 3D Body: Process Image to Pose JSON — SAM 3D Body で入力画像を解析し、ポーズを JSON として出力
    • mask 入力が未接続の場合は内蔵 BiRefNet Lite による自動マスクにフォールバック
    • 精度を上げたいときは明示的に MASK ノードを接続
    • 任意入力 Left_hand_image / Right_hand_image — IMAGE を渡すと hand-only decoder で別途解析し、本体推論結果の hand_pose_params[:54] (左) / [54:] (右) のみを上書き。手首の向きは本体ポーズに従います。出力ノードの追加はなし

ボディプリセット / レンダリング

  1. SAM 3D Body: Setting Body Preset JSON — preset と body / bone / blendshape スライダー一式を持ち、body_preset_json (STRING) を出力する設定ノード（旧 Render ノードのボディプリセット部分が独立化）
  2. SAM 3D Body: Render Human From Pose And Body Preset JSON — pose_json + body_preset_json を入力に取り、カメラ系設定 (offset_x/y / scale_offset / camera_yaw/pitch_deg / width / height) と前のめり補正 (pose_adjust) のみウィジェット化したレンダリングノード

Web UI エディタ（ブラウザ内モーダル、JA/EN 切替）

  1. SAM 3D Body: Pose Editor — 「Open Pose Editor」ボタンで起動。画像アップ → セグメンテーション + ポーズ推定 → 3D ボーン微調整 → 確定で 7 種の出力を返します:
    • pose_json (STRING)、width / height (INT)
    • pose_image (IMAGE) — 3D ビューのスクリーンショット。エディタ内の 画像範囲 ボタンで赤枠 D&D による出力範囲指定 + 背景色指定 で背景色変更が可能
    • input_image (IMAGE) — アップロードした元画像をそのまま再出力
    • hand_l_image / hand_r_image (IMAGE) — エディタで読み込んだ手画像（左右反転反映済み）。エディタの Input セクション内 D&D 入力欄から指定でき、入っている場合は本体ポーズの手だけを上書きします
  2. SAM 3D Body: Pose Editor + — 「Open Pose Editor +」ボタンで起動する多人数版 Pose Editor。1 枚の画像内で複数キャラクターの bbox + 高さを指定し、SAM 2 マスク + SAM 3D Body 推論で各人物の 3D 素体を生成。人物ごとに IK ポーズ調整 / 体形プリセット / 7. SAM 3D Body: Body Preset Editor** — 「Open Body Preset Editor」ボタンで起動。スライダー + 3D プレビューで体形を作り込み、確定で body_preset_json (STRING) を出力。メニュー末尾の Download JSON ボタンで現在のスライダー値を JSON ファイルとしてローカル保存可能

FBX / BVH 書き出し（いずれも Blender 必須）

  1. SAM 3D Body: Export Rigged FBX — アーマチュア + スキニング済みメッシュ + ポーズアニメ付きの FBX を <ComfyUI>/output/ に書き出す
  2. SAM 3D Body: Export Animated FBX — 動画 (IMAGE バッチ) から連続モーションをベイクしたアニメーション FBX を書き出す
  3. SAM 3D Body: Export Posed BVH — 単一ポーズを humanoid 互換の BVH として <ComfyUI>/output/ に書き出す
  4. SAM 3D Body: Export Animated BVH — 動画 (IMAGE バッチ) または pose 配列から連続モーション BVH を書き出す

Meta の SAM 3D Body と Momentum Human Rig (MHR) がバンドルされており、それぞれのオリジナルライセンスに従います (詳細は License)。

Installation

前提環境

GPU / VRAM 要件

SAM 3D Body の重み (約 3.4 GB) を常時 GPU に保持し、推論時のアクティベーションは 100 MB 未満で済む比較的軽量なモデルです。実測値（RTX A6000 / 1024×1024 入力 / 1 人物検出）:

項目推論タイプ full推論タイプ body
モデル重み（常駐）3,374 MB3,374 MB
推論中の追加アクティベーション+93 MB+69 MB
総ピーク VRAM約 3.5 GB約 3.5 GB
初回推論時間3.06 s1.47 s
2 回目以降（ウォーム後）1.13 s0.27 s

推奨スペック:

用途推奨 VRAM例
絶対最低（このプラグイン単体で動かす）4 GBGTX 1650 など
快適（OS / 他プロセスと共存）6 GBRTX 3050 / 4060 など
ComfyUI で他モデル（SDXL / Qwen-Image-Edit など）と併用8 GB 以上RTX 3060 12GB / 4070 など（併用モデル次第）

モデルはモジュールレベルでキャッシュされる (_MODEL_CACHE) ため、ノードを 2 回目以降実行しても VRAM は増えません。CPU でも動作しますが大幅に遅くなるため CUDA を推奨します。

Blender が必要な機能 ⚠

以下の 2 機能を使う場合は Blender のインストールが必須 です。動作確認は Blender 4.1 (C:/Program Files/Blender Foundation/Blender 4.1/blender.exe)。

機能Blender 必須の理由
新規ブレンドシェイプの追加・編集tools/bone_backup/all_parts_bs.fbx のシェイプキーを GUI で直接編集 + tools/extract_face_blendshapes.py を Blender headless で呼び出して presets/face_blendshapes.npz を再生成
SAM 3D Body: Export Rigged FBX ノードノード実行時に blender.exe --background --python tools/build_rigged_fbx.py を subprocess で呼び出し、armature / mesh / LBS 重み / ポーズアニメ を組み立てて FBX 書き出し
SAM 3D Body: Export Animated FBX ノードノード実行時に blender.exe --background --python tools/build_animated_fbx.py を subprocess で呼び出し、動画フレームごとの回転キーフレームをベイクしてアニメーション FBX を書き出す
SAM 3D Body: Export Posed BVH ノードノード実行時に blender.exe --background --python tools/build_rigged_bvh.py を subprocess で呼び出し、単一ポーズの BVH を書き出す
SAM 3D Body: Export Animated BVH ノードノード実行時に blender.exe --background --python tools/build_animated_bvh.py を subprocess で呼び出し、動画または pose 配列から BVH を書き出す

Blender ダウンロード先:

通常インストール (推奨)

  1. C:\ComfyUI\custom_nodes0 (ComfyUI のcustom_nodes/` 直下) にこのリポジトリを配置
  2. ComfyUI の Python 環境で以下を実行： 
    cd C:/ComfyUI/custom_nodes/ComfyUI-SAM3DBody_utills
C:/ComfyUI/.venv/Scripts/python.exe -m pip install -r requirements.txt
C:/ComfyUI/.venv/Scripts/python.exe install.py
  3. ComfyUI を起動 — 初回起動時に jetjodh/sam-3d-body-dinov3 から SAM 3D Body のモデル重み (約 1.5 GB) が <ComfyUI>/models/sam3dbody/ へ自動ダウンロードされます

※python3.11系でAttributeError: 'WindowsPath' object has no attribute 'is_junction' というエラーが出てくる場合は、他のcomfy-envを使ったカスタムノードで、comfy-envのバージョンがpython3.11には新しすぎる為起きています。 他のcomfy-envを使ったカスタムノードを見つけだし、そのrequirements.txtを以下に書き換えて下さい。 comfy-env==0.1.75

License

本プロジェクトは multi-license 構成 です。「どこが / どのライセンスか」を先に示すと次の 3 区分になります。ライセンス全文は docs/licenses/ 配下。

区分対象ファイル・アセットライセンス著作権者
自作コード（ComfyUI ラッパー）nodes/（nodes/sam_3d_body/ を除く）, tools/, web/, install.py, __init__.py, prestartup_script.py など ComfyUI 統合コード全般MIT License <br>(LICENSE-MIT)Copyright (c) 2025 Andrea Pozzetti（継承元）
SAM 部分（Meta SAM 3D Body 本体）nodes/sam_3d_body/ 配下のベンダードライブラリ（モデル・推論コード）SAM License <br>(LICENSE-SAM)Copyright (c) Meta Platforms, Inc. and affiliates
MHR 関連（Momentum Human Rig + 派生データ）mhr_model.pt アセット、および MHR トポロジを前提に作った派生データ：presets/face_blendshapes.npz、presets/ 配下の per-object 頂点 JSON、tools/bone_backup/all_parts_bs.fbxApache License 2.0 <br>(LICENSE-MHR / NOTICE-MHR)Copyright (c) Meta Platforms, Inc. and affiliates

注：この fork 差分も MIT のまま追加しています（wrapper 部分の著作権表記は継承元 Andrea Pozzetti のものが基準です）。また MHR は「アセットを同梱しているだけでなく、MHR のメッシュトポロジを前提にオーサリングした派生データも Apache 2.0 の派生物扱い」である点に注意してください。

リポジトリ全体の概要は LICENSE、第三者コード・アセットの帰属一覧は THIRD_PARTY_NOTICES を参照してください。

Using This Project

Community

この fork に関する質問・機能要望は tori29umai0123/ComfyUI-SAM3DBody_utills の Issues / Discussions へ。

SAM 3D Body / MHR 本体や upstream の話題は PozzettiAndrea/ComfyUI-SAM3DBody の Discussions および Comfy3D Discord が参考になります。

同梱ワークフロー例

workflows/ に 7 種類のサンプルワークフローを同梱しています。ComfyUI のメニューから Workflow → Open で読み込んでください。テスト入力として workflows/input_image*.png / workflows/input_mask*.png がそのまま使えます。

ファイル内容Blender 必須
SAM3Dbody_webUI.jsonWeb UI エディタ版。SAM 3D Body: Pose Editor と SAM 3D Body: Body Preset Editor をブラウザ内モーダルで操作し、確定値を Render ノードに直結する最小構成❌
SAM3Dbody_image.jsonシンプルな画像レンダリングワークフロー。入力した画像のポーズを、任意の体形でレンダリングする構成❌
SAM3Dbody_FBX.jsonFBX 出力ワークフロー。入力した画像のポーズを任意の体形に適用し、アニメーション付き FBX として書き出す (Unity / Unreal Engine などで読み込み可能)✅
SAM3Dbody_FBXAnimation.json動画モーションキャプチャ用ワークフロー。VHS_LoadVideo で読み込んだ動画を SAM 3D Body: Export Animated FBX に流し込み、連続モーション付き FBX を出力する✅
SAM3Dbody_ BVH.jsonBVH 出力ワークフロー。入力画像のポーズを任意の体形に適用し、単一ポーズ BVH として書き出す。3D プレビューノードなし✅
SAM3Dbody_BVHAnimation.json動画モーションキャプチャ用 BVH ワークフロー。VHS_LoadVideo のフレーム列を SAM 3D Body: Export Animated BVH に流し込み、連続モーション BVH を出力する。3D プレビューノードなし✅
SAM3Dbody _QIE_VNCCSpose.json実際の使用例ワークフロー。Qwen-Image-Edit-2511 と VNCCSpose LoRA を組み合わせて、体形違いのキャラクター画像からポーズを抽出し、任意の体形の 3D 素体でレンダリングした結果を元に画像編集を行う❌

SAM3Dbody_webUI.json の使い方 — ブラウザ内エディタでポーズ / ボディプリセットを確定

ComfyUI のキャンバス上のスライダーで延々と数値を打ち込む代わりに、ブラウザ内のフルスクリーンモーダルで 3D プレビューを見ながらポーズ推定とボディプリセット編集ができる、2 つの専用ノードを使う最小構成です。確定値は workflow JSON に保存されるので、ノードを閉じ直しても結果は失われません。日英 UI 切替対応。

SAM 3D Body: Pose Editor — ブラウザでポーズを確定

Pose Editor

ノードに付いた 「Open Pose Editor」 ボタンを押すと、画像アップロード → セグメンテーション + ポーズ推定 → 3D ビュー上でのボーン微調整 (回転 / IK 移動 / 前かがみ補正) → 「Confirm & Close / 確定して閉じる」 までを 1 つのモーダル内で完結できます。確定すると pose_json (STRING) と画像サイズ width / height (INT) がノードから出力され、SAM 3D Body: Render Human From Pose And Body Preset JSON の入力に直接繋げます。

画像出力 (IMAGE): 確定時に以下の 4 つの IMAGE 出力もあわせて返されます。

出力内容
pose_image3D ビューのスクリーンショット（後述の範囲指定／背景色指定が反映される）
input_imageアップロードした元画像をそのまま再出力（後段の合成・比較用）
hand_l_imageエディタの Input 内に読み込んだ左手画像（左右反転後）
hand_r_image同・右手画像

画像範囲 / 背景色指定 (pose_image 用): 3D ビューの左上に 「画像範囲」 ボタンと 「背景色指定」 ボタンが出ます。

SAM 3D Body: Pose Editor + — 多人数版 Pose Editor

SAM 3D Body: Pose Editor を多人数対応に拡張したバリアント。1 枚の画像内に複数のキャラクターが居るシーンで、人物ごとに bbox + 高さを指定して SAM 2 マスクと SAM 3D Body 推論をかけ、それぞれの 3D 素体を同時に生成・編集できます。ノード入力は blender_exe 1 つだけ（FBX / BVH の人物別出力で使用）で、その他の設定はすべてエディタ内で完結します。

Body Preset Editor

同様に 「Open Body Preset Editor」 ボタンで、MHR ニュートラル T-pose 素体に対して PCA 9 軸の体形 / 4 部位のボーン長 / 顔・体ブレンドシェイプ をスライダーで調整しながら、3D プレビューでリアルタイム反映できます。presets/<active>/body_preset_settings/*.json のプリセット読み込みもこの画面から可能。確定すると body_preset_json (STRING) が出力され、Render ノードや SAM 3D Body: Export Rigged FBX などにそのまま流せます。

サイドバー末尾の 「Download JSON」 ボタンを押すと、現在のスライダー値を body_preset_settings/*.json 互換のフォーマットでローカルに保存できます。エディタ外で他のワークフローと共有したり、バックアップしたい場合に便利です。

SAM3Dbody _QIE_VNCCSpose.json の使い方

sample3

このプラグインの出力画像を、Qwen-Image-Edit のような画像編集モデルに渡す中間出力物として使う運用を想定したワークフローです。「ポーズは参照キャラクターから、体形は別ボディプリセットから」という 2 系統の入力を、ポーズ正確な 3D 素体を経由してマージできます。

SAM 3D Body: Render Human From Pose And Body Preset JSON ノード

pose_json と body_preset_json を入力に取り、3D 素体をレンダリングするノード。ボディプリセット設定 (PCA 体型 / ボーン長 / ブレンドシェイプ) は body_preset_json に切り出されているため、このノードに残るウィジェットは カメラ系コントロール + 前のめり補正のみ で構成は非常にシンプル。

入力（必須）

パラメータ既定範囲説明
model——SAM 3D Body モデル（Load ノードの出力）
pose_json"{}"—ポーズ JSON（Process Image to Pose JSON ノード または Pose Editor の出力）
body_preset_json"{}"—ボディプリセット JSON（Setting Body Preset JSON ノード または Body Preset Editor の出力）
offset_x0.0−5.0 〜 5.0水平方向の位置オフセット（メートル単位で camera[0] に加算）。画像内で被写体を左右にずらす
offset_y0.0−5.0 〜 5.0垂直方向の位置オフセット（camera[1] に加算）。画像内で被写体を上下にずらす
scale_offset1.00.1 〜 5.0カメラ距離の乗算オフセット。1.0 で等倍、0.1 で極端に近寄る、5.0 で遠ざかる
camera_yaw_deg0.0−180 〜 180横軸オービット。被写体重心を中心にカメラを水平回転。+ でカメラが視聴者の右へ回り込み、被写体が左を向いたように見える。±180 で真後ろ
camera_pitch_deg0.0−89 〜 89縦軸オービット。被写体重心を中心にカメラを垂直回転。+ でカメラが上に上がり見下ろし、− で見上げ。被写体は画面中央に留まる
width00 〜 8192出力幅（0 = pose_json の元画像サイズを使用）
height00 〜 8192出力高（0 = pose_json の元画像サイズを使用）
pose_adjust0.00.0 〜 1.0前のめり補正の強さ。SAM 3D Body は立位の被写体をやや前傾に推定する傾向があるので、spine→neck チェーンを後ろに反らせて補正。1.0 でフル補正、写実 (実写) には 0.0、イラスト系には 0.5 程度が目安

入力（任意）

パラメータ説明
background_image背景画像。未接続なら黒背景

出力

出力説明
imageレンダリング結果の RGB 画像

SAM 3D Body: Setting Body Preset JSON ノード

旧 Render ノードのボディプリセット部分だけを切り出した独立ノード。preset と PCA 9 軸の体型 / 4 部位のボーン長 / 顔・体ブレンドシェイプを全スライダー制御し、body_preset_json (STRING) を出力する。Render ノードや Export Rigged FBX ノード等の body_preset_json / body_preset_json 入力に直結できる。

入力

パラメータ既定説明
presetautosaveプリセット選択。autosave がデフォルトで先頭固定
body_*0.0PCA 9 軸の体型スライダー（後述）
bone_*1.0ボーン長スケール 4 種（後述）
bs_*0.0ブレンドシェイプ 20 種（後述）

出力

出力説明
body_preset_jsonボディプリセット JSON 文字列。body_params / bone_lengths / blendshapes の 3 ブロックを持つ、body_preset_settings/*.json 互換の構造

Body Params（PCA 体型）— body_*

MHR モデルの 45 次元 PCA 体型空間の先頭 9 成分を直接操作する 9 スライダー。

スライダー名は MHR の PCA 軸が学習した意味に基づく推定で、実際に動く方向と名前が完全一致しない可能性あり（効果は実際に動かして確認）。

パラメータ担当 PCA 成分想定される効果
body_fatshape_params[0]体脂肪量。正=太る、負=痩せる
body_muscleshape_params[1]筋肉量。正=筋肉質、負=華奢
body_fat_muscleshape_params[2]脂肪と筋肉の比率
body_limb_girthshape_params[3]四肢（腕・脚）の太さ
body_limb_muscleshape_params[4]四肢の筋肉量
body_limb_fatshape_params[5]四肢の皮下脂肪量
body_chest_shouldershape_params[6]胸囲・肩幅。正=広い、負=狭い
body_waist_hipshape_params[7]ウエスト・ヒップ。正=太い、負=細い
body_thigh_calfshape_params[8]太もも・ふくらはぎの太さ

ボーン長スケール — bone_*

MHR 骨格のリンク長を部位別にスケーリングする 4 スライダー。LBS を per-joint 等方スケール に拡張した定式化で、骨の長さ変更と同時にその joint 周辺のメッシュも等方的にスケールする。結果、プロポーションを保ったまま部位の長さだけが変わる（例: bone_torso=0.6 で胴体は 0.6 倍に短くなるが、太さも同じく 0.6 倍になるので「チビ」になっても「ずんぐり」にはならない）。

パラメータ既定範囲適用される MHR ジョイント
bone_torso1.00.3 〜 1.8pelvis 自身 + pelvis → neck_01 のチェーン（股下から首の根元まで）。pelvis も対象に含めることで下腹部メッシュも一緒に縮む
bone_neck1.00.3 〜 2.0neck_01 → head リンク（首の長さ）。head の mesh_scale は 1.0 固定 — 頭のサイズは変わらず首だけ伸び縮みする
bone_arm1.00.3 〜 2.0clavicle_l/r の子孫（upperarm, lowerarm, hand, 指）
bone_leg1.00.3 〜 2.0thigh_l/r の子孫（calf, foot, つま先）

実装は _apply_bone_length_scales (nodes/processing/process.py)。joint_scale と mesh_scale の 2 系統を分離しており、_MESH_SCALE_STRENGTH=0.5 の緩衝で「骨の長さが 40% 縮んでもメッシュは 20% しか細くならない」ようバランスを取っている。

ブレンドシェイプ — bs_*

FBX の tools/bone_backup/all_parts_bs.fbx から抽出したモーフターゲットを線形ブレンドで適用する 20 スライダー。各スライダーは 既定 0.0、範囲 0.0〜1.0、1.0 でフル有効。複数同時に動かすと加算合成される。

シェイプの一覧は presets/face_blendshapes.npz から自動発見される — Blender で新しいシェイプキーを追加して npz を再生成すれば、再起動後に UI に現れる（コード変更不要）。UI 上の bs_ プレフィックスは見やすさのためで、FBX 側のキー名・body_preset_json 側のキーではプレフィックスなし。

顔

パラメータ説明
bs_face_big顔全体を大きくする
bs_face_small顔全体を小さくする
bs_face_mangabig漫画的に顔を大きく盛る
bs_face_manga漫画的な顔立ち
bs_chin_sharp顎先をシャープにする

首

パラメータ説明
bs_neck_thick首を太くする
bs_neck_thin首を細くする

胸

パラメータ説明
bs_breast_full胸を膨らませる
bs_breast_flat胸を平らにする
bs_chest_slim胸郭をスリムにする

肩

パラメータ説明
bs_shoulder_wide肩幅を広げる
bs_shoulder_narrow肩幅を狭める
bs_shoulder_slopeなで肩／いかり肩を調整

腰

パラメータ説明
bs_waist_slimウエストを細くする

手足

パラメータ説明
bs_limb_thick手足を太くする
bs_limb_thin手足を細くする
bs_hand_big手そのものを拡大
bs_foot_big足先を拡大

筋肉

パラメータ説明
bs_MuscleScale全身の筋肉量を増やす（マッチョ化）

プリセットシステム

body_preset_settings/<name>.json に上記形式の JSON を置くと、UI の preset プルダウンから選択できる。選択時は preset の値が UI スライダーを完全に上書きする（未記載のキーはニュートラル値扱い）。同梱の female.json / male.json が参考例。

⚠ Export Rigged FBX ノード（Blender 必須）

レンダリングと同じボディプリセット + ポーズを、アーマチュア + スキニング済みメッシュ + 30 フレームの静止ポーズアニメーション付きのリギング済み FBX として <ComfyUI>/output/ に書き出すノード。Blender / Unity / Unreal Engine でそのままインポートできます。

⚠ このノードの実行には Blender 4.1 以上のインストールが必須です。 ノード内部で blender.exe --background --python tools/build_rigged_fbx.py を subprocess として呼び出し、armature 構築・LBS スキニング・FBX エクスポートを行うためです。Blender を入れていない環境ではこのノードだけ実行時にエラーになります (他の 3 ノードは動きます)。

入力

パラメータ説明
modelLoad SAM 3D Body Model の出力
body_preset_jsonボディプリセット JSON。Render ノードの settings_json 出力を直結するか、body_preset_settings/*.json の内容を貼り付ける (body_params / bone_lengths / blendshapes を含む)。UI テキストエリアの冒頭に === BODY PRESET JSON === と表示されるのが目印
pose_jsonポーズ JSON。SAM 3D Body: Process Image to Pose JSON ノードの pose_json 出力を直結 (body_pose_params / hand_pose_params / global_rot を含む)。UI テキストエリアの冒頭に === POSE JSON === と表示されるのが目印
blender_exeBlender の実行ファイルパス (既定 C:/Program Files/Blender Foundation/Blender 4.1/blender.exe)。subprocess で呼び出すため Blender 4.1 以上が必要
output_filename出力 FBX 名 (既定 sam3d_rigged.fbx)。空にするとタイムスタンプ付きで自動命名

出力

出力説明
fbx_path書き出した FBX の絶対パス (<ComfyUI>/output/<name>.fbx)

⚠ Export Animated FBX ノード（動画モーションキャプチャ / Blender 必須）

動画 (IMAGE バッチ) から Unity / Unreal でそのまま再生できるモーション付き FBX を 1 ノードで書き出すノードです。ComfyUI-VideoHelperSuite の VHS_LoadVideo 等で読み込んだフレーム列を渡すと、各フレームを SAM 3D Body に通してジョイント回転を推定し、基本姿勢 (body_pose=0) でリグ付けされたキャラクターにすべてのフレームをキーフレームとしてベイクします。出力 FBX はそのまま Animator / Animation / Timeline から再生可能です。

出力イメージは README 冒頭の デモ動画 (docs/sample1.mp4) を参照してください。

⚠ Export Posed BVH ノード（Blender 必須）

単一ポーズを <ComfyUI>/output/ 配下に BVH として書き出すノードです。Render ノードで作った体形設定と Process Image to Pose JSON のポーズをそのまま使えます。出力はメッシュなしの skeleton / motion のみで、humanoid 互換になるよう BVH 用に骨を整理してから書き出します。

⚠ 実行には Blender 4.1 以上が必須です。 内部で blender.exe --background --python tools/build_rigged_bvh.py を subprocess として呼び出します。

開発者ガイド (Blender でブレンドシェイプを編集したい人向け)

ここから先は、Blender で tools/bone_backup/all_parts_bs.fbx を編集して新しいブレンドシェイプを追加・変更したい上級ユーザー向けの内容です。 同梱済みの 18 ブレンドシェイプをそのまま使うだけなら読み飛ばしてかまいません。

新ブレンドシェイプの追加手順、extract_face_blendshapes.py / rebuild_vertex_jsons.py 等の実行コマンド、tools/ 配下のスクリプト一覧は別ドキュメントに分割しました：

Credits

SAM 3D Body by Meta AI (paper)

下载此文件