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

# TripoImageToModelNodeV2 - ComfyUI Built-in Node Documentation

> Tripo: Image to Model 노드는 Tripo의 image-to-model 서비스를 사용하여 단일 참조 이미지를 3D 모델로 변환합니다. 이미지를 업로드하고, 생성 작업을 제출하고, 작업이 완료될 때까지 기다린 후, 결과 3D 파일을 작업 ID와 함께 반환합니다. 이 노드는 API 노드이므로 유효한 Comfy

Tripo: Image to Model 노드는 Tripo의 image-to-model 서비스를 사용하여 단일 참조 이미지를 3D 모델로 변환합니다. 이미지를 업로드하고, 생성 작업을 제출하고, 작업이 완료될 때까지 기다린 후, 결과 3D 파일을 작업 ID와 함께 반환합니다. 이 노드는 API 노드이므로 유효한 Comfy API 키가 필요합니다.

## 입력

| 매개변수                | 설명                                                                                                                                                     | 데이터 타입  | 필수  | 범위                                        |
| ------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------ | ------- | --- | ----------------------------------------- |
| `image`             | 3D 모델을 생성하는 데 사용되는 참조 이미지입니다.                                                                                                                          | IMAGE   | 예   | —                                         |
| `model_version`     | 생성에 사용할 모델 버전입니다. 설정하지 않으면 노드는 Tripo의 v3.1 (20260211) 버전으로 대체합니다.                                                                                      | COMBO   | 아니요 | Tripo 모델 버전 목록                            |
| `texture`           | 텍스처 맵을 생성합니다. 끄면 텍스처 없는 지오메트리를 반환하고 `pbr`을 무시합니다 (기본값: true).                                                                                          | BOOLEAN | 아니요 | true<br />false                           |
| `pbr`               | PBR 머티리얼 맵(베이스 컬러, 메탈릭, 러프니스, 노멀)입니다. `texture`가 필요합니다 (기본값: true).                                                                                    | BOOLEAN | 아니요 | true<br />false                           |
| `model_seed`        | 지오메트리 생성 단계에 사용되는 시드입니다 (기본값: 42).                                                                                                                     | INT     | 아니요 | 0 \~ 2147483647                           |
| `orientation`       | 생성된 모델에 적용되는 방향 설정입니다 (기본값: DEFAULT).                                                                                                                  | COMBO   | 아니요 | Tripo 방향 옵션, 기본값 `DEFAULT`                |
| `texture_seed`      | 텍스처 생성 단계에 사용되는 시드입니다 (기본값: 42).                                                                                                                       | INT     | 아니요 | 0 \~ 2147483647                           |
| `texture_quality`   | detailed = HD 텍스처, extreme = 8K 울트라 텍스처 (기본값: "standard").                                                                                             | COMBO   | 아니요 | "standard"<br />"detailed"<br />"extreme" |
| `texture_alignment` | 생성된 지오메트리에서 텍스처가 정렬되는 방식입니다 (기본값: "original\_image").                                                                                                  | COMBO   | 아니요 | "original\_image"<br />"geometry"         |
| `face_limit`        | 최대 면 수입니다. -1은 Tripo가 적응형으로 선택하도록 합니다(v3.x standard에서 약 140만 면, detailed에서 200만 면). Tripo는 별도 알림 없이 제한합니다: v2.5는 500,000, 쿼드 메시는 150,000입니다 (기본값: -1). | INT     | 아니요 | -1 \~ 2000000                             |
| `quad`              | 쿼드 메시 출력입니다. Tripo는 쿼드 메시를 FBX로 전달하므로 결과는 FBX 출력으로 나오고 GLB 출력은 비어 있게 됩니다 (기본값: false).                                                                 | BOOLEAN | 아니요 | true<br />false                           |
| `geometry_quality`  | 생성된 지오메트리의 품질 수준입니다 (기본값: "standard").                                                                                                                 | COMBO   | 아니요 | "standard"<br />"detailed"                |
| `smart_low_poly`    | 깔끔한 수작업 스타일 토폴로지를 가진 로우 폴리 메시입니다(500-20,000면, 쿼드 500-10,000). 단순한 대상에 가장 적합하며, 복잡한 대상은 실패할 수 있습니다 (기본값: false).                                        | BOOLEAN | 아니요 | true<br />false                           |
| `auto_size`         | 텍스처가 있는 모델을 실제 크기(미터)로 조정합니다. Tripo는 크기를 모델의 장면 변환으로 저장하고 모델이 변환, 리깅 또는 리타게팅될 때 이를 베이킹합니다. 텍스처가 없으면 무시됩니다 (기본값: true).                                 | BOOLEAN | 아니요 | true<br />false                           |

**참고:**

* `image`는 필수입니다. 이미지가 제공되지 않으면 노드에서 오류가 발생합니다.
* `smart_low_poly`가 활성화되고 `face_limit`이 -1이 아닌 값으로 설정된 경우, 제한은 삼각형 메시의 경우 500에서 20,000 사이여야 하며, `quad`가 활성화된 경우 500에서 10,000 사이여야 합니다. 다른 값은 오류를 발생시킵니다.
* `texture`가 비활성화되면 `pbr`은 설정에 관계없이 강제로 꺼지고, `auto_size`는 효과가 없습니다.
* `face_limit`이 -1이면 Tripo에 "no limit"으로 전송되어 서비스가 적응형으로 선택할 수 있습니다.
* 노드가 반환할 수 없는 새로운 3D 파일 형식(GLB 또는 FBX 이외의 형식)은 오류를 발생시킵니다.

## 출력

| 출력 이름           | 설명                                          | 데이터 타입          |
| --------------- | ------------------------------------------- | --------------- |
| `model task_id` | 생성 작업의 Tripo 작업 ID입니다.                      | MODEL\_TASK\_ID |
| `GLB`           | GLB 파일로 생성된 모델입니다. `quad`가 활성화되면 비어 있습니다.   | FILE3DGLB       |
| `FBX`           | FBX 파일로 생성된 모델입니다. `quad`가 활성화된 경우에만 채워집니다. | FILE3DFBX       |

> 이 문서는 AI에 의해 생성되었습니다. 오류를 발견하거나 개선 제안이 있으시면 기여해 주세요! [GitHub에서 편집](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/TripoImageToModelNodeV2/ko.md)

***

**Source fingerprint (SHA-256):** `c8c069432f67a019995b9f4dedbf5ca3f7594ae4004104277068106821189c11`