> ## 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

> TripoRetargetNode는 기존 리깅된 3D 모델에 프리셋 애니메이션을 적용합니다. 이전에 리깅된 모델의 작업 ID를 받아 Tripo API에 리타게팅 요청을 보내고, 생성된 애니메이션 파일을 다운로드합니다. 애니메이션된 모델은 GLB 또는 FBX로 반환될 수 있으며, 선택적 메시 지오메트리와 선택적 제자리 재생을

TripoRetargetNode는 기존 리깅된 3D 모델에 프리셋 애니메이션을 적용합니다. 이전에 리깅된 모델의 작업 ID를 받아 Tripo API에 리타게팅 요청을 보내고, 생성된 애니메이션 파일을 다운로드합니다. 애니메이션된 모델은 GLB 또는 FBX로 반환될 수 있으며, 선택적 메시 지오메트리와 선택적 제자리 재생을 지원합니다.

## 입력

| 매개변수                   | 설명                                                                                                                                                                                                                | 데이터 타입                  | 필수  | 범위                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| ---------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------- | --- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `원본 모델 작업 ID`          | 리타게팅할 이전에 리깅된 3D 모델의 작업 ID입니다. 참조된 작업은 리그 작업이어야 합니다.                                                                                                                                                              | RIG\_TASK\_ID           | 예   | -                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| `애니메이션`                | 리깅된 모델에 적용할 애니메이션 프리셋입니다. `preset:*` 애니메이션은 두 리그 모델 모두에서 작동합니다. `preset:biped:*` 애니메이션은 모델 v1.0-20240301의 리그용으로 만들어졌으며, v2.5 리그는 chop, climb, dive, fall, hurt, idle, jump, run, shoot, slash, turn, walk만 허용합니다. | COMBO                   | 예   | `"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 />추가로 UI에 표시되는 `"preset:biped:*"` 옵션 |
| `out_format`           | 출력 파일 형식이며, 결과는 일치하는 출력으로 전달됩니다. (기본값: glb)                                                                                                                                                                       | COMBO                   | 아니요 | `"glb"`<br />`"fbx"`                                                                                                                                                                                                                                                                                                                                                                                                                |
| `export_with_geometry` | 내보내기에 메시를 포함합니다. 끄면 애니메이션된 스켈레톤만 내보냅니다. (기본값: True)                                                                                                                                                               | BOOLEAN                 | 아니요 | True<br />False                                                                                                                                                                                                                                                                                                                                                                                                                     |
| `animate_in_place`     | 루트 변위 없이 제자리에서 애니메이션을 재생합니다. (기본값: False)                                                                                                                                                                         | BOOLEAN                 | 아니요 | True<br />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:*` 그룹의 애니메이션은 두 리그 모델 모두에서 작동합니다. `preset:biped:*` 그룹의 애니메이션은 모델 v1.0-20240301의 리그용으로 만들어졌으며, v2.5 리그는 chop, climb, dive, fall, hurt, idle, jump, run, shoot, slash, turn, walk만 허용합니다. 참조된 리그가 Mixamo 사양과 `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에서 편집](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/TripoRetargetNode/ko.md)

***

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