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

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