> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-comfy-docs-comfyapi-search.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# 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"`<br />`"preset:walk"`<br />`"preset:run"`<br />`"preset:dive"`<br />`"preset:climb"`<br />`"preset:jump"`<br />`"preset:slash"`<br />`"preset:shoot"`<br />`"preset:hurt"`<br />`"preset:fall"`<br />`"preset:turn"`<br />`"preset:quadruped:walk"`<br />`"preset:hexapod:walk"`<br />`"preset:octopod:walk"`<br />`"preset:serpentine:march"`<br />`"preset:aquatic:march"`<br />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"`<br />`"fbx"`                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| `export_with_geometry`   | Include the mesh in the export; off exports the animated skeleton only. (default: True)                                                                                                                                                                                          | BOOLEAN                 | No       | True<br />False                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| `animate_in_place`       | Play the animation in place, without root displacement. (default: False)                                                                                                                                                                                                         | BOOLEAN                 | No       | True<br />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](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/TripoRetargetNode/en.md)

***

**Source fingerprint (SHA-256):** `4814858b940ece13f85010ff81fcdac0258fe8550aebd914be2613e8f40c0e5a`
