TripoRetargetNode - ComfyUI Built-in Node Documentation

The TripoRetargetNode applies a preset animation to an existing rigged 3D model.

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.	RIG_TASK_ID	Yes	-
animation	The animation preset to apply to the rigged model. preset:* animations work with both rig models. preset:biped:* animations are made for rigs from model v1.0-20240301; a v2.5 rig accepts only chop, climb, dive, fall, hurt, idle, jump, run, shoot, slash, turn and walk.	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. Animations in the preset:biped:* group are made for rigs from model v1.0-20240301; a v2.5 rig accepts only chop, climb, dive, fall, hurt, idle, jump, run, shoot, slash, turn and walk. 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. The requested output format must be GLB or FBX; if the service returns any other file type, the node raises 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): 4814858b940ece13f85010ff81fcdac0258fe8550aebd914be2613e8f40c0e5a