MeshyImageToModelNode - ComfyUI Built-in Node Documentation

Meshy: Image to Model 노드는 Meshy API를 사용하여 단일 입력 이미지에서 3D 모델을 생성합니다. 이미지를 업로드하고 처리 작업을 제출한 후 생성된 3D 모델 파일(GLB 및 FBX)과 참조용 작업 ID를 반환합니다.

입력

매개변수	설명	데이터 유형	필수 여부	범위
`model`	생성에 사용할 AI 모델 버전을 지정합니다.	COMBO	예	`"meshy-7.1"` `"meshy-7"` `"meshy-6"` `"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`	베이스 컬러에 더해 PBR 맵(금속성, 거칠기, 법선)을 생성합니다. 이 입력은 `should_texture` 값이 `"true"`로 설정된 경우에만 사용할 수 있습니다. 기본값: `False`.	BOOLEAN	아니요*	-
`texture_prompt`	텍스처링 과정을 안내하는 텍스트 프롬프트를 제공합니다. 최대 600자입니다. `texture_image`와 동시에 사용할 수 없습니다. 이 입력은 `should_texture` 값이 `"true"`로 설정된 경우에만 사용할 수 있습니다. 기본값: 빈 문자열.	STRING	아니요*	-
`texture_image`	`texture_image`와 `texture_prompt` 중 하나만 동시에 사용할 수 있습니다. 이 입력은 `should_texture` 값이 `"true"`로 설정된 경우에만 사용할 수 있습니다.	IMAGE	아니요*	-
`texture_resolution`	베이스 컬러 텍스처 해상도입니다. 해상도가 높을수록 더 세밀한 표면 디테일을 포착합니다. 이 입력은 `should_texture` 값이 `"true"`로 설정된 경우에만 사용할 수 있습니다.	COMBO	아니요*	`"2k"` `"4k"` `"8k"`
`pose_mode`	생성된 모델의 포즈 모드를 지정합니다. 고급 매개변수입니다.	COMBO	예	`""` (empty) `"A-pose"` `"T-pose"`
`seed`	시드는 노드 재실행 여부를 제어합니다. 시드와 관계없이 결과는 비결정적입니다. 기본값: 0.	INT	예	0 - 2147483647
`ultra_mode`	더 미세한 표면 디테일과 더 높은 정밀도의 지오메트리를 위해 추가 정제 패스를 실행합니다. 기본값: `False`.	BOOLEAN	예	-
`ultra_resolution`	울트라 패스의 해상도: `"2k"`는 2048³, `"4k"`는 4096³에서 실행되어 가장 세밀한 표면 디테일을 제공합니다. `"4k"`에는 `"meshy-7.1"` 또는 `"latest"` 모델이 필요합니다. `ultra_mode`가 활성화된 경우에만 사용됩니다(기본값: `"2k"`).	COMBO	아니요	`"2k"` `"4k"`

매개변수 제약 조건 참고:

topology 및 target_polycount 입력은 should_remesh 값이 "true"로 설정된 경우에만 사용할 수 있습니다.
enable_pbr, texture_prompt, texture_image, texture_resolution 입력은 should_texture 값이 "true"로 설정된 경우에만 사용할 수 있습니다.
should_texture 값이 "true"로 설정된 경우 texture_prompt와 texture_image는 동시에 사용할 수 없습니다. 둘 다 제공되면 노드에서 오류가 발생합니다.
texture_prompt의 최대 길이는 600자입니다.
ultra_mode가 활성화된 경우 model 매개변수를 "meshy-7.1", "meshy-7", "latest" 중 하나로 설정해야 합니다. 다른 모델을 선택하면 오류가 발생합니다. "meshy-7"에서는 울트라 패스가 항상 2048³으로 실행되며, "4k" 해상도에는 "meshy-7.1" 또는 "latest"가 필요합니다.

출력

출력 이름	설명	데이터 유형
`model_file`	생성된 GLB 모델의 파일 이름입니다. 이전 버전과의 호환성을 위해서만 유지됩니다.	STRING
`meshy_task_id`	Meshy API 작업의 고유 식별자로, 참조 또는 문제 해결에 사용할 수 있습니다.	MESHY_TASK_ID
`GLB`	GLB 파일 형식으로 생성된 3D 모델입니다.	FILE3DGLB
`FBX`	FBX 파일 형식으로 생성된 3D 모델입니다.	FILE3DFBX

이 문서는 AI에 의해 생성되었습니다. 오류를 발견하거나 개선 제안이 있으시면 기여해 주세요! GitHub에서 편집

Source fingerprint (SHA-256): 38528b48c3f792a459008a52f65fae248ef1dadafb37fe4dc6b697d25bc89f4f

​입력

​출력

입력

출력