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

# TripoPSeriesImageToModelNode - ComfyUI Built-in Node Documentation

> Tripo의 P2 모델을 사용하여 단일 이미지로부터 깔끔한 토폴로지를 가진 로우폴리 3D 모델을 생성합니다. 결과는 삼각형 메시(GLB)로 반환되며, model.quad가 활성화된 경우에는 쿼드 중심 메시(FBX)로 반환됩니다.

Tripo의 P2 모델을 사용하여 단일 이미지로부터 깔끔한 토폴로지를 가진 로우폴리 3D 모델을 생성합니다. 결과는 삼각형 메시(GLB)로 반환되며, `model.quad`가 활성화된 경우에는 쿼드 중심 메시(FBX)로 반환됩니다.

## 입력

### 공통 입력

| 매개변수 | 설명                                                    | 데이터 타입         | 필수 | 범위     |
| ---- | ----------------------------------------------------- | -------------- | -- | ------ |
| `모델` | 사용할 Tripo P-시리즈 모델입니다. 모델을 선택하면 아래에 해당 모델의 입력이 표시됩니다. | DYNAMIC\_COMBO | 예  | `"P2"` |

### P2 입력

| 매개변수                   | 설명                                                                                                               | 데이터 타입  | 필수 | 범위                                                            |
| ---------------------- | ---------------------------------------------------------------------------------------------------------------- | ------- | -- | ------------------------------------------------------------- |
| `model.image`          | 모델을 생성하는 데 사용할 이미지입니다.                                                                                           | IMAGE   | 예  | -                                                             |
| `쿼드`                   | GLB 출력의 삼각형 메시 대신 FBX 출력에 쿼드 중심 메시를 반환합니다(기본값: False).                                                           | BOOLEAN | 예  | True/False                                                    |
| `face_limit`           | 목표 면 수입니다. `-1`은 Tripo가 선택하도록 합니다. `model.quad`가 활성화된 경우 제한은 48~~25,000이며, 그렇지 않으면 48~~50,000입니다(기본값: -1).       | INT     | 예  | -1 또는 48 \~ 50000                                             |
| `텍스처`                  | 기본 색상 텍스처 해상도: standard는 2K, detailed는 4K, extreme은 8K입니다. `"none"`은 텍스처가 없는 메시를 반환합니다(기본값: `"standard"`).       | COMBO   | 예  | `"standard"`<br />`"detailed"`<br />`"extreme"`<br />`"none"` |
| `pbr`                  | 기본 색상에 메탈릭, 러프니스 및 노멀 맵을 추가합니다. `model.texture`가 `"none"`일 때는 무시됩니다(기본값: True).                                  | BOOLEAN | 예  | True/False                                                    |
| `model_seed`           | 지오메트리용 시드입니다(기본값: 42).                                                                                           | INT     | 예  | 0 \~ 2147483647                                               |
| `texture_alignment`    | 입력 이미지의 색상과 일치시키거나 생성된 지오메트리에 텍스처를 맞춥니다. `model.texture`가 `"none"`일 때는 무시됩니다(기본값: `"original_image"`). 고급 설정입니다. | COMBO   | 예  | `"original_image"`<br />`"geometry"`                          |
| `방향`                   | `"align_image"`는 모델을 입력 이미지의 시점에 맞게 회전합니다. `model.texture`가 `"none"`일 때는 무시됩니다(기본값: `"default"`). 고급 설정입니다.      | COMBO   | 예  | `"default"`<br />`"align_image"`                              |
| `enable_image_autofix` | 모델링 전에 Tripo가 저해상도 또는 저품질 이미지를 개선하도록 합니다(기본값: False). 고급 설정입니다.                                                  | BOOLEAN | 예  | True/False                                                    |
| `texture_seed`         | 텍스처용 시드입니다(기본값: 42). 고급 설정입니다.                                                                                   | INT     | 예  | 0 \~ 2147483647                                               |
| `auto_size`            | 씬 변환을 통해 모델을 실제 크기(미터)로 조정합니다. `model.texture`가 `"none"`일 때는 무시됩니다 (기본값: False). 고급 설정입니다.                       | BOOLEAN | 예  | True/False                                                    |
| `export_uv`            | 메시에 텍스처가 없을 때 UV 언랩합니다. 텍스처가 있는 메시는 항상 언랩됩니다(기본값: True). 고급 설정입니다.                                               | BOOLEAN | 예  | True/False                                                    |
| `compress_geometry`    | meshopt 지오메트리 압축을 적용합니다. 파일 크기가 훨씬 작아지지만 ComfyUI의 3D 미리보기에서는 표시할 수 없습니다. 쿼드 메시에는 무시됩니다(기본값: False). 고급 설정입니다.    | BOOLEAN | 예  | True/False                                                    |

**참고:**

* `model.image`는 필수이며, 배치의 첫 번째 이미지만 사용됩니다.
* `model.face_limit`는 엄격한 상한이 아니라 목표값이므로, 결과가 요청한 것보다 더 많은 면을 포함할 수 있습니다. `-1`은 선택을 Tripo에 맡깁니다.
* `model.quad`는 어느 출력이 메시를 전달할지 결정합니다. 활성화하면 모델은 FBX 출력으로 전달되고 GLB 출력은 비어 있습니다. 비활성화하면 모델은 GLB로 전달되고 FBX는 비어 있습니다. 연결한 출력이 비어 있는 출력인 경우 노드에서 오류를 발생시킵니다.
* `model.texture`, `model.pbr`, `model.texture_seed`, `model.auto_size`, `model.texture_alignment` 및 `model.orientation`은 텍스처가 있는 모델에만 적용됩니다. `"none"`인 경우 노드는 텍스처 설정을 전송하지 않고 텍스처 없는 지오메트리만 반환합니다.
* `model.compress_geometry`는 쿼드 메시에 아무런 영향을 주지 않습니다.

## 출력

| 출력 이름           | 설명                                                   | 데이터 타입          |
| --------------- | ---------------------------------------------------- | --------------- |
| `model task_id` | 모델 생성 요청의 고유 작업 ID입니다.                               | MODEL\_TASK\_ID |
| `GLB`           | GLB 형식의 생성된 3D 모델입니다. `model.quad`가 활성화된 경우 비어 있습니다. | FILE3DGLB       |
| `FBX`           | FBX 형식의 생성된 3D 모델입니다. `model.quad`가 활성화된 경우에만 채워집니다. | FILE3DFBX       |

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

***

**Source fingerprint (SHA-256):** `9bfad31ee00546d0603ce3273502cfc93c79e3b125941fed255866aa83f770a5`