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

# TripoTextureNode - ComfyUI Built-in Node Documentation

> Tripo: Texture model (Legacy) 노드는 Tripo API를 통해 기존 Tripo 3D 모델에 텍스처를 추가합니다. 다른 Tripo 노드에서 생성된 모델의 작업 ID를 받아 텍스처 작업이 완료되면 텍스처가 적용된 GLB 또는 FBX 모델을 반환합니다. 머티리얼 맵, 텍스처 품질, 정렬, 시드를 제어할

Tripo: Texture model (Legacy) 노드는 Tripo API를 통해 기존 Tripo 3D 모델에 텍스처를 추가합니다. 다른 Tripo 노드에서 생성된 모델의 작업 ID를 받아 텍스처 작업이 완료되면 텍스처가 적용된 GLB 또는 FBX 모델을 반환합니다. 머티리얼 맵, 텍스처 품질, 정렬, 시드를 제어할 수 있으며, 텍스트 프롬프트, 스타일 이미지 또는 참조 이미지로 텍스처를 안내할 수 있습니다. 이 노드는 텍스처 도구의 레거시 버전입니다.

## 입력

### 공통 입력

| 매개변수             | 설명                                                                                                                                       | 데이터 타입                             | 필수 여부 | 범위                                        |
| ---------------- | ---------------------------------------------------------------------------------------------------------------------------------------- | ---------------------------------- | ----- | ----------------------------------------- |
| `모델 작업 ID`       | 텍스처를 적용할 모델의 Tripo 작업 ID입니다. 모델 작업 ID와 세그멘테이션 작업 ID를 허용합니다.                                                                              | MODEL\_TASK\_ID, SEGMENT\_TASK\_ID | 예     | -                                         |
| `텍스처`            | 무시됩니다. 이 노드는 항상 텍스처를 생성합니다. 이전 워크플로를 위해 유지됩니다. (기본값: True)                                                                               | BOOLEAN                            | 아니요   | true<br />false                           |
| `PBR`            | PBR 머티리얼 맵(베이스 컬러, 메탈릭, 러프니스, 노멀)입니다. 끄면 단색 텍스처를 생성합니다. (기본값: True)                                                                      | BOOLEAN                            | 아니요   | true<br />false                           |
| `텍스처 시드`         | 텍스처 생성을 위한 랜덤 시드입니다. (기본값: 42)                                                                                                           | INT                                | 아니요   | 0 – 2147483647                            |
| `텍스처 품질`         | 텍스처 해상도 품질입니다. detailed = HD 텍스처, extreme = 8K Ultra 텍스처입니다. (기본값: "standard"). 대략적인 비용: standard $0.10, detailed $0.20, extreme \$0.30. | COMBO                              | 아니요   | "standard"<br />"detailed"<br />"extreme" |
| `텍스처 정렬`         | 생성된 텍스처를 모델에 정렬하는 데 사용하는 방법입니다. (기본값: "original\_image")                                                                                 | COMBO                              | 아니요   | "original\_image"<br />"geometry"         |
| `texture_prompt` | 텍스처링을 위한 선택적 텍스트 안내입니다. 색상을 추론할 원본 이미지가 없는 가져온 모델(Tripo: Import Model)에서는 실제로 필수입니다. 참조 이미지와 함께 사용할 수 없습니다. (기본값: "")                    | STRING                             | 아니요   | -                                         |
| `model_version`  | 텍스처 모델입니다. v3.x로 생성된 메시에는 v3.0을, v2.5로 생성된 메시에는 v2.5를 사용합니다. (기본값: v3.0\_20250812)                                                       | COMBO                              | 아니요   | 여러 옵션 사용 가능                               |
| `style_image`    | 텍스처의 예술적 스타일을 위한 참조 이미지입니다. `texture_prompt`와 함께 사용할 때만 적용됩니다.                                                                           | IMAGE                              | 아니요   | -                                         |
| `reference`      | 텍스처를 안내하는 참조 이미지입니다. `texture_prompt` 또는 `style_image`와 함께 사용할 수 없습니다. (기본값: "none")                                                     | DYNAMIC\_COMBO                     | 아니요   | "none"<br />"image"<br />"multiview"      |
| `part_names`     | 텍스처링할 Tripo: Segment Model의 파트 이름을 쉼표로 구분한 목록입니다. 비워 두면 모든 파트에 텍스처를 적용합니다. (기본값: "")                                                     | STRING                             | 아니요   | -                                         |

### `image` 참조 입력

이러한 입력은 `reference`가 `"image"`로 설정된 경우 사용할 수 있습니다.

| 매개변수              | 설명                       | 데이터 타입 | 필수 여부 | 범위 |
| ----------------- | ------------------------ | ------ | ----- | -- |
| `reference_image` | 텍스처가 따라야 할 단일 참조 이미지입니다. | IMAGE  | 예     | -  |

### `multiview` 참조 입력

이러한 입력은 `reference`가 `"multiview"`로 설정된 경우 사용할 수 있습니다.

| 매개변수          | 설명               | 데이터 타입 | 필수 여부 | 범위 |
| ------------- | ---------------- | ------ | ----- | -- |
| `image_front` | 정면 보기(0°)입니다.    | IMAGE  | 예     | -  |
| `image_left`  | 왼쪽 보기(90°)입니다.   | IMAGE  | 예     | -  |
| `image_back`  | 후면 보기(180°)입니다.  | IMAGE  | 예     | -  |
| `image_right` | 오른쪽 보기(270°)입니다. | IMAGE  | 예     | -  |

**참고:** `"image"` 및 `"multiview"` 참조 모드는 비어 있지 않은 `texture_prompt` 또는 `style_image`와 함께 사용할 수 없습니다. `style_image` 입력을 사용하려면 비어 있지 않은 `texture_prompt`가 필요합니다. `texture_prompt`를 비워 두면 소스 모델에 이미 자체 소스 이미지가 있어야 합니다(예: text-to-model, image-to-model, multiview-to-model 또는 이전 텍스처링 작업으로 생성된 모델). 가져온 모델, 세그먼트된 모델, 완료된 모델 또는 리토폴로지된 모델처럼 소스 이미지가 없는 모델은 `texture_prompt`로 텍스처링해야 합니다. 참조 이미지는 Tripo API가 자체적으로 생성한 모델에만 허용됩니다. `part_names` 입력을 비워 두면 모든 파트를 텍스처링할 수 있습니다.

## 출력

| 출력 이름           | 설명                                                                               | 데이터 타입          |
| --------------- | -------------------------------------------------------------------------------- | --------------- |
| `model_file`    | 생성된 모델 파일입니다(하위 호환성 전용).                                                         | STRING          |
| `model task_id` | 완료된 텍스처 생성 작업의 작업 ID로, 다른 Tripo 노드의 입력으로 사용할 수 있습니다.                             | MODEL\_TASK\_ID |
| `GLB`           | GLB 형식으로 생성된 텍스처 모델입니다. 소스가 쿼드 메시 또는 FBX 가져오기인 경우 비어 있습니다.                       | FILE3DGLB       |
| `FBX`           | FBX 형식으로 생성된 텍스처 모델입니다. Tripo는 쿼드 메시와 FBX 가져오기에 대해 FBX를 반환하며, 그 외의 경우에는 비어 있습니다. | FILE3DFBX       |

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

***

**Source fingerprint (SHA-256):** `850685123b5f14cded5829d86a7307452a1e812e78d11f52806e64ea41d66350`