TripoRetargetNode - ComfyUI Built-in Node Documentation - ComfyUI

The TripoRetargetNode applies a preset animation to an existing rigged 3D model. It takes the task ID of a model that was previously rigged, sends a retarget request to the Tripo API, and downloads the resulting animated file. The animated model can be returned as GLB or FBX, with optional mesh geometry and optional in-place playback.

Inputs

Parameter	Description	Data Type	Required	Range
`original_model_task_id`	The task ID of the previously rigged 3D model to retarget. The referenced task must be a rig task; a rig made with the Mixamo spec on model version v1.0 cannot be used for retargeting.	RIG_TASK_ID	Yes	-
`animation`	The animation preset to apply to the rigged model. `preset:` animations work with both rig models; `preset:biped:` animations require a rig made with model v1.0-20240301.	COMBO	Yes	`"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"` plus additional `"preset:biped:*"` options shown in the UI
`out_format`	Output file format; the result arrives on the matching output. (default: glb)	COMBO	No	`"glb"` `"fbx"`
`export_with_geometry`	Include the mesh in the export; off exports the animated skeleton only. (default: True)	BOOLEAN	No	True False
`animate_in_place`	Play the animation in place, without root displacement. (default: False)	BOOLEAN	No	True False
`auth_token_comfy_org`	Authentication token for Comfy.org API access (hidden parameter).	AUTH_TOKEN_COMFY_ORG	No	-
`api_key_comfy_org`	API key for Comfy.org service access (hidden parameter).	API_KEY_COMFY_ORG	No	-
`unique_id`	Unique identifier for tracking the operation (hidden parameter).	UNIQUE_ID	No	-

Note: Animations in the preset:* group work with both rig models, while animations in the preset:biped:* group require a rig made with model v1.0-20240301. If the referenced rig was created with the Mixamo spec and a model version starting with v1.0, the retargeting call fails with an error.

Outputs

Output Name	Description	Data Type
`model_file`	The generated animated 3D model file (for backward compatibility only).	STRING
`retarget task_id`	The task ID for tracking the retargeting operation.	RETARGET_TASK_ID
`GLB`	The animated 3D model in GLB format. Populated when `out_format` is glb.	FILE3DGLB
`FBX`	The animated 3D model in FBX format. Populated when `out_format` is fbx.	FILE3DFBX

This documentation was AI-generated. If you find any errors or have suggestions for improvement, please feel free to contribute! Edit on GitHub

Source fingerprint (SHA-256): e5417a8fa584285ba9e57526e65b091c2383374c70364df9053777a3ce09541a