TripoRetargetNode - ComfyUI Built-in Node Documentation

The TripoRetargetNode 将预设动画应用于现有的已绑定骨骼的 3D 模型。

The TripoRetargetNode 将预设动画应用于现有的已绑定骨骼的 3D 模型。它接收先前已绑定骨骼的模型的任务 ID，向 Tripo API 发送重定向请求，并下载生成的动画文件。动画模型可作为 GLB 或 FBX 返回，并可选择包含网格几何体以及可选的原地播放。

​

输入

参数	描述	数据类型	是否必填	取值范围
原始模型任务ID	先前已绑定骨骼的 3D 模型的任务 ID，用于重定向。引用的任务必须是 rig 任务。	RIG_TASK_ID	是	-
动画	要应用于 rig 模型的动画预设。preset:* 动画适用于两种 rig 模型。preset:biped:* 动画是为 model v1.0-20240301 的 rig 制作的；v2.5 rig 仅接受 chop、climb、dive、fall、hurt、idle、jump、run、shoot、slash、turn 和 walk。	COMBO	是	"preset:idle" "preset:walk" "preset:run" "preset:dive" "preset:climb" "preset:jump" "preset:slash" "preset:shoot" "preset:hurt" "preset:fall" "preset:turn" "preset:quadruped:walk" "preset:hexapod:walk" "preset:octopod:walk" "preset:serpentine:march" "preset:aquatic:march" 以及 UI 中显示的其他 "preset:biped:*" 选项
out_format	输出文件格式；结果会出现在匹配的输出中。（默认：glb）	COMBO	否	"glb" "fbx"
export_with_geometry	导出时包含网格；关闭时仅导出动画骨架。（默认：True）	BOOLEAN	否	True False
animate_in_place	在原地播放动画，不产生根位移。（默认：False）	BOOLEAN	否	True False
auth_token_comfy_org	用于 Comfy.org API 访问的认证令牌（隐藏参数）。	AUTH_TOKEN_COMFY_ORG	否	-
api_key_comfy_org	用于 Comfy.org 服务访问的 API 密钥（隐藏参数）。	API_KEY_COMFY_ORG	否	-
unique_id	用于跟踪操作的唯一标识符（隐藏参数）。	UNIQUE_ID	否	-

注意：preset:* 组中的动画适用于两种 rig 模型。preset:biped:* 组中的动画是为 model v1.0-20240301 的 rig 制作的；v2.5 rig 仅接受 chop、climb、dive、fall、hurt、idle、jump、run、shoot、slash、turn 和 walk。如果引用的 rig 是使用 Mixamo spec 和以 v1.0 开头的模型版本创建的，则重定向调用会失败并报错。请求的输出格式必须是 GLB 或 FBX；如果服务返回任何其他文件类型，节点会引发错误。

​

输出

输出名称	描述	数据类型
model_file	生成的动画 3D 模型文件（仅用于向后兼容）。	STRING
retarget task_id	用于跟踪重定向操作的任务 ID。	RETARGET_TASK_ID
GLB	GLB 格式的动画 3D 模型。当 out_format 为 glb 时填充。	FILE3DGLB
FBX	FBX 格式的动画 3D 模型。当 out_format 为 fbx 时填充。	FILE3DFBX

本文档由 AI 生成。如果您发现任何错误或有改进建议，欢迎贡献！ 在 GitHub 上编辑

---

Source fingerprint (SHA-256): 4814858b940ece13f85010ff81fcdac0258fe8550aebd914be2613e8f40c0e5a