MeshyImageToModelNode - ComfyUI Built-in Node Documentation

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"일 때 두 입력이 모두 제공되면 노드에서 오류가 발생합니다.

출력

출력 이름	설명	데이터 타입
`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): 134d9250d8b447bbbd2905f827e81b67f491ba355ebb93d4d256324b644100a2

​입력

​출력

입력

출력