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

# MeshyMultiImageToModelNode - ComfyUI Built-in Node Documentation

> Complete documentation for the MeshyMultiImageToModelNode node in ComfyUI. Learn its inputs, outputs, parameters and usage.

이 노드는 Meshy API를 사용하여 여러 입력 이미지로부터 3D 모델을 생성합니다. 제공된 이미지를 업로드하고 처리 작업을 제출한 후, 결과 3D 모델 파일(GLB 및 FBX)과 참조용 작업 ID를 반환합니다.

## 입력

| 매개변수               | 설명                                                                                                                                     | 데이터 타입  | 필수 여부 | 범위                                           |
| ------------------ | -------------------------------------------------------------------------------------------------------------------------------------- | ------- | ----- | -------------------------------------------- |
| `model`            | 사용할 AI 모델 버전을 지정합니다.                                                                                                                   | COMBO   | 예     | `"latest"`                                   |
| `images`           | 3D 모델 생성에 사용되는 이미지 세트입니다. 2\~4개의 이미지를 제공해야 합니다.                                                                                        | IMAGE   | 예     | 2\~4개 이미지                                    |
| `should_remesh`    | 생성된 메시를 처리할지 여부를 결정합니다. `"false"`로 설정하면 처리되지 않은 삼각형 메시가 반환됩니다.                                                                         | COMBO   | 예     | `"true"`<br />`"false"`                      |
| `topology`         | 리메시된 출력의 대상 폴리곤 유형입니다. 이 매개변수는 `should_remesh`가 `"true"`로 설정된 경우에만 사용 가능하며 필수입니다.                                                      | COMBO   | 아니요   | `"triangle"`<br />`"quad"`                   |
| `target_polycount` | 리메시된 모델의 대상 폴리곤 수입니다(기본값: 300000). 이 매개변수는 `should_remesh`가 `"true"`로 설정된 경우에만 사용 가능합니다.                                               | INT     | 아니요   | 100\~300000                                  |
| `symmetry_mode`    | 생성된 모델에 대칭을 적용할지 여부를 제어합니다.                                                                                                            | COMBO   | 예     | `"auto"`<br />`"on"`<br />`"off"`            |
| `should_texture`   | 텍스처를 생성할지 여부를 결정합니다. `"false"`로 설정하면 텍스처 단계를 건너뛰고 텍스처가 없는 메시가 반환됩니다.                                                                   | COMBO   | 예     | `"true"`<br />`"false"`                      |
| `enable_pbr`       | `should_texture`가 `"true"`인 경우, 이 옵션은 기본 색상 외에 PBR 맵(메탈릭, 러프니스, 노멀)을 추가로 생성합니다(기본값: False).                                            | BOOLEAN | 아니요   | True / False                                 |
| `texture_prompt`   | 텍스처링 과정을 안내하는 텍스트 프롬프트입니다(최대 600자). `texture_image`와 동시에 사용할 수 없습니다. 이 매개변수는 `should_texture`가 `"true"`로 설정된 경우에만 사용 가능합니다.            | STRING  | 아니요   | -                                            |
| `texture_image`    | 텍스처링 과정을 안내하는 이미지입니다. `texture_image` 또는 `texture_prompt` 중 하나만 동시에 사용할 수 있습니다. 이 매개변수는 `should_texture`가 `"true"`로 설정된 경우에만 사용 가능합니다. | IMAGE   | 아니요   | -                                            |
| `pose_mode`        | 생성된 모델의 포즈 모드를 지정합니다.                                                                                                                  | COMBO   | 예     | `""` (비어 있음)<br />`"A-pose"`<br />`"T-pose"` |
| `seed`             | 생성 과정의 시드 값입니다(기본값: 0). 시드와 관계없이 결과는 비결정적이지만, 시드를 변경하면 노드가 다시 실행될 수 있습니다.                                                              | INT     | 예     | 0\~2147483647                                |

**매개변수 제약 조건:**

* `images` 입력에는 2\~4개의 이미지를 제공해야 합니다.
* `topology` 및 `target_polycount` 매개변수는 `should_remesh`가 `"true"`로 설정된 경우에만 활성화됩니다.
* `enable_pbr`, `texture_prompt` 및 `texture_image` 매개변수는 `should_texture`가 `"true"`로 설정된 경우에만 활성화됩니다.
* `texture_prompt`와 `texture_image`는 동시에 사용할 수 없으며, 상호 배타적입니다.

## 출력

| 출력 이름           | 설명                                            | 데이터 타입          |
| --------------- | --------------------------------------------- | --------------- |
| `meshy_task_id` | 생성된 GLB 모델의 파일 이름입니다. 이 출력은 하위 호환성을 위해 제공됩니다. | STRING          |
| `GLB`           | Meshy API 작업의 고유 식별자입니다.                      | MESHY\_TASK\_ID |
| `FBX`           | GLB 형식으로 생성된 3D 모델입니다.                        | FILE3DGLB       |
| `FBX`           | FBX 형식으로 생성된 3D 모델입니다.                        | FILE3DFBX       |

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

***

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