# Meshy: 이미지-모델 노드 Meshy: 이미지-모델 노드는 Meshy API를 사용하여 단일 입력 이미지로부터 3D 모델을 생성합니다. 이미지를 업로드하고 처리 작업을 제출한 후, 생성된 3D 모델 파일(GLB 및 FBX)과 참조용 작업 ID를 반환합니다. ## 입력 | 매개변수 | 설명 | 데이터 타입 | 필수 여부 | 범위 | | --- | --- | --- | --- | --- | | `model` | 생성에 사용할 AI 모델 버전을 지정합니다. | COMBO | 예 | `"latest"` | | `image` | 3D 모델로 변환할 입력 이미지입니다. | IMAGE | 예 | - | | `should_remesh` | 생성된 메시를 처리할지 여부를 결정합니다. `"false"`로 설정하면 처리되지 않은 삼각형 메시가 반환됩니다. | DYNAMIC COMBO | 예 | `"true"`
`"false"` | | `topology` | 리메시된 모델의 대상 폴리곤 토폴로지입니다. 이 입력은 `should_remesh`가 `"true"`로 설정된 경우에만 사용 가능합니다. | COMBO | 아니요* | `"triangle"`
`"quad"` | | `target_polycount` | 리메시된 모델의 대상 폴리곤 수입니다. 이 입력은 `should_remesh`가 `"true"`로 설정된 경우에만 사용 가능합니다. 기본값은 300000입니다. | INT | 아니요* | 100 - 300000 | | `symmetry_mode` | 생성된 3D 모델에 적용되는 대칭을 제어합니다. | COMBO | 예 | `"auto"`
`"on"`
`"off"` | | `should_texture` | 모델에 텍스처를 생성할지 여부를 결정합니다. `"false"`로 설정하면 텍스처 단계를 건너뛰고 텍스처가 없는 메시가 반환됩니다. | DYNAMIC COMBO | 예 | `"true"`
`"false"` | | `enable_pbr` | `should_texture`가 `"true"`인 경우, 이 옵션은 기본 색상 외에 PBR 맵(메탈릭, 거칠기, 노멀)을 생성합니다. 기본값은 `False`입니다. | BOOLEAN | 아니요* | - | | `texture_prompt` | 텍스처링 과정을 안내하는 텍스트 프롬프트입니다(최대 600자). 이 입력은 `should_texture`가 `"true"`로 설정된 경우에만 사용 가능합니다. `texture_image`와 동시에 사용할 수 없습니다. | STRING | 아니요* | - | | `texture_image` | 텍스처링 과정을 안내하는 이미지입니다. 이 입력은 `should_texture`가 `"true"`로 설정된 경우에만 사용 가능합니다. `texture_prompt`와 동시에 사용할 수 없습니다. | IMAGE | 아니요* | - | | `pose_mode` | 생성된 모델의 포즈 모드를 지정합니다. 고급 매개변수입니다. | COMBO | 예 | `""` (빈 값)
`"A-pose"`
`"T-pose"` | | `seed` | 생성 과정을 위한 시드 값입니다. 시드 값과 관계없이 결과는 비결정적입니다. 기본값은 0입니다. | INT | 예 | 0 - 2147483647 | **매개변수 제약 조건 참고:** * `topology` 및 `target_polycount` 입력은 `should_remesh`가 `"true"`로 설정된 경우에만 사용 가능합니다. * `enable_pbr`, `texture_prompt` 및 `texture_image` 입력은 `should_texture`가 `"true"`로 설정된 경우에만 사용 가능합니다. * `texture_prompt`와 `texture_image`를 동시에 사용할 수 없습니다. `should_texture`가 `"true"`일 때 두 입력이 모두 제공되면 노드에서 오류가 발생합니다. ## 출력 | 출력 이름 | 설명 | 데이터 타입 | | --- | --- | --- | | `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/MeshyImageToModelNode/ko.md) --- **Source fingerprint (SHA-256):** `134d9250d8b447bbbd2905f827e81b67f491ba355ebb93d4d256324b644100a2`