> ## 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.
# TripoImageToModelNode - ComfyUI Built-in Node Documentation
> Tripo의 API를 사용하여 단일 이미지를 기반으로 3D 모델을 동기적으로 생성합니다. 입력 이미지를 제공하면 노드가 이를 바탕으로 완성된 3D 모델을 생성하며, 모델 버전, 텍스처 생성, 세부 수준, 출력 형식에 대한 선택적 제어를 제공합니다. 이는 이미지-투-모델 노드의 레거시 버전으로, 이전 워크플로를 위해 유지됩
Tripo의 API를 사용하여 단일 이미지를 기반으로 3D 모델을 동기적으로 생성합니다. 입력 이미지를 제공하면 노드가 이를 바탕으로 완성된 3D 모델을 생성하며, 모델 버전, 텍스처 생성, 세부 수준, 출력 형식에 대한 선택적 제어를 제공합니다. 이는 이미지-투-모델 노드의 레거시 버전으로, 이전 워크플로를 위해 유지됩니다.
## 입력
| 매개변수 | 설명 | 데이터 타입 | 필수 | 범위 |
| ------------------ | ---------------------------------------------------------------------------------------------------------------------------------------- | ------- | --- | -------------------------------------------------------------------------------------------------- |
| `이미지` | 3D 모델을 생성하는 데 사용되는 입력 이미지입니다. 이미지를 반드시 제공해야 하며, 그렇지 않으면 노드에서 오류가 발생합니다. | IMAGE | 예 | - |
| `모델 버전` | 생성에 사용할 모델 버전입니다. | COMBO | 아니요 | `"v1.4"`
`"v3.0"`
`"v3.5"`
`"v3.6"` |
| `스타일` | Tripo에서 더 이상 지원하지 않으며 무시됩니다. 이전 워크플로를 위해 유지됩니다. (기본값: `"None"`) | COMBO | 아니요 | `"None"`
`"realistic"`
`"cartoon"`
`"sculpture"`
`"low_poly"` |
| `텍스처` | 텍스처 맵을 생성합니다. 끄면 기본 지오메트리만 반환하고 `pbr`은 무시됩니다. (기본값: True) | BOOLEAN | 아니요 | True
False |
| `PBR` | PBR 머티리얼 맵(베이스 컬러, 메탈릭, 러프니스, 노멀)입니다. `texture`가 필요합니다. (기본값: True) | BOOLEAN | 아니요 | True
False |
| `모델 시드` | 모델 생성을 위한 랜덤 시드입니다. (기본값: 42) | INT | 아니요 | 0 \~ 2147483647 |
| `방향` | 생성된 모델의 방향 설정입니다. (기본값: `"default"`) | COMBO | 아니요 | `"default"`
`"front"`
`"back"`
`"left"`
`"right"`
`"top"`
`"bottom"` |
| `텍스처 시드` | 텍스처 생성을 위한 랜덤 시드입니다. (기본값: 42) | INT | 아니요 | 0 \~ 2147483647 |
| `텍스처 품질` | 텍스처 생성을 위한 품질 수준입니다. `detailed` = HD 텍스처, `extreme` = 8K 울트라 텍스처입니다. (기본값: `"standard"`) | COMBO | 아니요 | `"standard"`
`"detailed"`
`"extreme"` |
| `텍스처 정렬` | 텍스처 매핑을 위한 정렬 방식입니다. (기본값: `"original_image"`) | COMBO | 아니요 | `"original_image"`
`"geometry"` |
| `얼굴 제한` | 최대 면 수입니다. -1은 Tripo가 적응적으로 선택하도록 합니다(v3.x 표준에서 약 140만 면, 상세에서 200만 면). Tripo는 별도 알림 없이 클램프합니다: v2.5는 500,000, 쿼드 메시는 150,000. (기본값: -1) | INT | 아니요 | -1 \~ 2000000 |
| `쿼드` | 쿼드 메시 출력입니다. Tripo는 쿼드 메시를 FBX로 전달하므로 결과는 FBX 출력으로 제공되고 GLB 출력은 비어 있게 됩니다. (기본값: False) | BOOLEAN | 아니요 | True
False |
| `geometry_quality` | 지오메트리 생성을 위한 품질 수준입니다. (기본값: `"standard"`) | COMBO | 아니요 | `"standard"`
`"detailed"` |
| `smart_low_poly` | 깔끔한 수작업 스타일 토폴로지를 갖춘 로우 폴리 메시입니다(500-20,000면, 쿼드 500-10,000). 단순한 대상에 가장 적합하며, 복잡한 대상은 실패할 수 있습니다. (기본값: False) | BOOLEAN | 아니요 | True
False |
| `auto_size` | 텍스처가 적용된 모델을 실제 세계 크기(미터)로 조정합니다. Tripo는 크기를 모델의 장면 변환으로 저장하고, 모델을 변환하거나 리깅하거나 리타게팅할 때 이를 베이크합니다. 텍스처가 없으면 무시됩니다. (기본값: True) | BOOLEAN | 아니요 | True
False |
참고: `image`는 필수입니다. 누락되면 노드에서 RuntimeError가 발생합니다. `texture`가 False이면 모델에는 기본 지오메트리만 포함되며 `pbr`은 강제로 False가 됩니다. `smart_low_poly`가 활성화된 경우 `face_limit`은 삼각형 메시의 경우 500에서 20,000 사이여야 하고, `quad`도 활성화된 경우 500에서 10,000 사이여야 합니다. 제한이 유효하지 않으면 노드에서 ValueError가 발생합니다. `face_limit`을 -1(기본값)로 설정하면 API에 명시적 면 제한을 보내지 않아 Tripo가 적응적으로 선택할 수 있습니다.
## 출력
| 출력 이름 | 설명 | 데이터 타입 |
| ------------ | ----------------------------------------------- | --------------- |
| `모델 파일` | 생성된 3D 모델 파일입니다(하위 호환성 전용). | STRING |
| `모델 task_id` | 모델 생성 프로세스를 추적하기 위한 작업 ID입니다. | MODEL\_TASK\_ID |
| `GLB` | GLB 형식으로 생성된 3D 모델입니다. `quad`가 활성화되면 비어 있습니다. | FILE3DGLB |
| `FBX` | FBX 형식으로 생성된 3D 모델입니다. `quad`가 활성화된 경우에만 채워집니다. | FILE3DFBX |
> 이 문서는 AI에 의해 생성되었습니다. 오류를 발견하거나 개선 제안이 있으시면 기여해 주세요! [GitHub에서 편집](https://github.com/Comfy-Org/embedded-docs/blob/main/comfyui_embedded_docs/docs/TripoImageToModelNode/ko.md)
***
**Source fingerprint (SHA-256):** `3b278abfd13329ee58ebab1bfeb47d32d09f4797f3d8628a35a028c3d15a7314`