Hunyuan3D: 이미지 → 모델 (Pro) - ComfyUI Built-in Node Documentation - ComfyUI

이 노드는 Tencent의 Hunyuan3D Pro API를 사용하여 하나 이상의 입력 이미지로부터 3D 모델을 생성합니다. 이미지를 처리하여 API로 전송한 후, 생성된 3D 모델 파일을 GLB 및 OBJ 형식과 함께 선택적 텍스처 맵으로 반환합니다.

입력

매개변수	설명	데이터 타입	필수 여부	범위
`모델`	사용할 Hunyuan3D 모델의 버전입니다. `3.1` 모델에서는 LowPoly 옵션을 사용할 수 없습니다.	COMBO	예	`"3.0"` `"3.1"`
`이미지`	3D 모델을 생성하는 데 사용되는 기본 입력 이미지입니다. 최소 128x128 픽셀이어야 합니다.	IMAGE	예	-
`왼쪽 이미지`	다중 뷰 생성을 위한 객체 왼쪽 측면의 선택적 이미지입니다. 최소 128x128 픽셀이어야 합니다.	IMAGE	아니요	-
`오른쪽 이미지`	다중 뷰 생성을 위한 객체 오른쪽 측면의 선택적 이미지입니다. 최소 128x128 픽셀이어야 합니다.	IMAGE	아니요	-
`뒷면 이미지`	다중 뷰 생성을 위한 객체 뒷면의 선택적 이미지입니다. 최소 128x128 픽셀이어야 합니다.	IMAGE	아니요	-
`면 개수`	생성된 3D 모델의 목표 면 수입니다(기본값: 500000).	INT	예	3000 - 1500000
`생성 유형`	생성할 3D 모델의 유형입니다. 옵션을 선택하면 추가 관련 매개변수가 표시됩니다.	DYNAMICCOMBO	예	`"Normal"` `"LowPoly"` `"Geometry"`
`generate_type.pbr`	물리 기반 렌더링(PBR) 재질 생성을 활성화합니다. 이 매개변수는 `생성 유형`이 “Normal” 또는 “LowPoly”로 설정된 경우에만 표시됩니다(기본값: False).	BOOLEAN	아니요	-
`generate_type.polygon_type`	메시에 사용할 폴리곤 유형입니다. 이 매개변수는 `생성 유형`이 “LowPoly”로 설정된 경우에만 표시됩니다.	COMBO	아니요	`"triangle"` `"quadrilateral"`
`시드`	생성 프로세스의 시드 값입니다. 시드는 노드 재실행 여부를 제어하며, 시드와 관계없이 결과는 비결정적입니다(기본값: 0).	INT	예	0 - 2147483647

참고: 모든 입력 이미지의 최소 너비와 높이는 128픽셀이어야 합니다. 이미지의 가장 긴 변이 4900픽셀을 초과하면 자동으로 축소됩니다.

출력

출력 이름	설명	데이터 타입
`모델 파일`	이전 버전과의 호환성을 위한 레거시 출력입니다.	STRING
`GLB`	GLB(Binary GL Transmission Format) 파일 형식으로 생성된 3D 모델입니다.	FILE3DGLB
`OBJ`	OBJ(Wavefront) 파일 형식으로 생성된 3D 모델입니다.	FILE3DOBJ
`texture_image`	생성된 3D 모델의 텍스처 이미지입니다.	IMAGE
`optional_metallic`	PBR 재질의 메탈릭 맵입니다. 사용할 수 없는 경우 검은색 이미지를 반환합니다.	IMAGE
`optional_normal`	PBR 재질의 노멀 맵입니다. 사용할 수 없는 경우 검은색 이미지를 반환합니다.	IMAGE
`optional_roughness`	PBR 재질의 러프니스 맵입니다. 사용할 수 없는 경우 검은색 이미지를 반환합니다.	IMAGE

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

Source fingerprint (SHA-256): 56ac9e55bd9bb3a5c7c46c2de1ea06921cf41c0971471f6d0b64166722705e4d