> ## Documentation Index
> Fetch the complete documentation index at: https://dripart-matt-router-pricing-pika-and-guard.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# TripoTextToModelNode - ComfyUI Built-in Node Documentation

> 이 레거시 노드는 Tripo의 API를 사용하여 텍스트 설명으로부터 완성된 3D 모델을 생성합니다. 생성이 완료될 때까지 기다린 다음 모델 파일을 반환하며, 선택적으로 텍스처와 PBR 재질을 포함할 수 있습니다. 이 노드는 더 이상 사용되지 않음(deprecated)으로 표시되어 있으며 이전 워크플로를 위해 유지됩니다.

이 레거시 노드는 Tripo의 API를 사용하여 텍스트 설명으로부터 완성된 3D 모델을 생성합니다. 생성이 완료될 때까지 기다린 다음 모델 파일을 반환하며, 선택적으로 텍스처와 PBR 재질을 포함할 수 있습니다. 이 노드는 더 이상 사용되지 않음(deprecated)으로 표시되어 있으며 이전 워크플로를 위해 유지됩니다.

## 입력

| 매개변수 | 설명 | 데이터 타입 | 필수 | 범위 |
| - | - | - | - | - |
| `프롬프트` | 생성할 3D 모델의 텍스트 설명입니다(여러 줄). 이 매개변수는 필수이며 비워 둘 수 없습니다. | STRING | 예 | - |
| `네거티브 프롬프트` | 생성된 모델에서 피해야 할 내용에 대한 텍스트 설명입니다(여러 줄). 최대 255자입니다. 비어 있지 않은 경우에만 API로 전송됩니다. | STRING | 아니요 | 최대 255자 |
| `모델 버전` | 생성에 사용할 Tripo 모델의 버전입니다(기본값: v3\_1\_20260211). | COMBO | 아니요 | 여러 옵션 사용 가능 |
| `스타일` | Tripo에서 더 이상 지원하지 않으며 무시됩니다. 이전 워크플로를 위해 유지됩니다(기본값: "None"). | COMBO | 아니요 | 여러 옵션 사용 가능 |
| `텍스처` | 텍스처 맵을 생성합니다. 끄면 기본 형상만 반환하고 `pbr`을 무시합니다(기본값: True). | BOOLEAN | 아니요 | true / false |
| `PBR` | PBR 재질 맵(베이스 컬러, 메탈릭, 러프니스, 노멀)입니다. `texture`가 필요하며, `texture`가 꺼져 있으면 강제로 꺼집니다(기본값: True). | BOOLEAN | 아니요 | true / false |
| `이미지 시드` | 이미지 생성 단계에 사용되는 시드입니다(기본값: 42). | INT | 아니요 | 0 \~ 2147483647 |
| `모델 시드` | 모델 생성 단계에 사용되는 시드입니다(기본값: 42). | INT | 아니요 | 0 \~ 2147483647 |
| `텍스처 시드` | 텍스처 생성 단계에 사용되는 시드입니다(기본값: 42). | INT | 아니요 | 0 \~ 2147483647 |
| `텍스처 품질` | 생성된 텍스처의 품질입니다. detailed = HD 텍스처, extreme = 8K 울트라 텍스처입니다(기본값: standard). | COMBO | 아니요 | "standard"<br />"detailed"<br />"extreme" |
| `얼굴 제한` | 최대 면 수입니다. -1은 Tripo가 적응적으로 선택하도록 합니다(v3.x standard에서 약 140만 면, detailed에서 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"<br />"detailed" |
| `smart_low_poly` | 깔끔한 수작업 스타일 토폴로지를 갖춘 로우폴리 메시입니다(500-20,000면, quad 500-10,000). 단순한 대상에 가장 적합하며, 복잡한 대상은 실패할 수 있습니다. (기본값: False) | BOOLEAN | 아니요 | true / false |
| `auto_size` | 텍스처가 있는 모델을 실제 크기(미터)로 조정합니다. Tripo는 크기를 모델의 장면 변환으로 저장하고, 모델을 변환, 리깅 또는 리타기팅할 때 이를 베이크합니다. 텍스처가 없으면 무시됩니다. (기본값: True) | BOOLEAN | 아니요 | true / false |

**참고 사항:**

* 이 노드는 더 이상 사용되지 않으며 레거시 노드로 표시됩니다. 이전 워크플로와의 하위 호환성을 위해 유지됩니다.
* `prompt` 매개변수는 필수입니다. 프롬프트가 비어 있으면 노드에서 오류가 발생합니다.
* `pbr`은 `texture`가 필요합니다. `texture`가 꺼져 있으면 노드는 `pbr`을 강제로 끄고 해당 값을 무시합니다. `auto_size`도 `texture`가 없으면 효과가 없습니다.
* `smart_low_poly`가 활성화되어 있고 `face_limit`이 -1이 아닌 값으로 설정된 경우, 면 제한은 삼각형 출력에서는 500에서 20,000 사이여야 하며, `quad`가 활성화된 경우에는 500에서 10,000 사이여야 합니다. 그렇지 않으면 노드에서 오류가 발생합니다.
* `quad`가 활성화되면 생성된 쿼드 메시는 FBX로 전달되므로 FBX 출력이 채워지고 GLB 출력은 비어 있습니다.
* `style` 매개변수는 허용되지만 무시됩니다.

## 출력

| 출력 이름 | 설명 | 데이터 타입 |
| - | - | - |
| `모델 파일` | 생성된 3D 모델 파일 이름으로 `<task_id>.<format>` 형식이며, 하위 호환성을 위해서만 유지됩니다. | STRING |
| `모델 task_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/TripoTextToModelNode/ko.md)

***

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


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.