메인 콘텐츠로 건너뛰기

Meshy: 이미지-모델 노드

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

입력

매개변수설명데이터 타입필수 여부범위
model생성에 사용할 AI 모델 버전을 지정합니다.COMBO"latest"
image3D 모델로 변환할 입력 이미지입니다.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_pbrshould_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입니다.INT0 - 2147483647
매개변수 제약 조건 참고:
  • topologytarget_polycount 입력은 should_remesh"true"로 설정된 경우에만 사용 가능합니다.
  • enable_pbr, texture_prompttexture_image 입력은 should_texture"true"로 설정된 경우에만 사용 가능합니다.
  • texture_prompttexture_image를 동시에 사용할 수 없습니다. should_texture"true"일 때 두 입력이 모두 제공되면 노드에서 오류가 발생합니다.

출력

출력 이름설명데이터 타입
meshy_task_id생성된 GLB 모델의 파일 이름입니다. (하위 호환성을 위해 유지됩니다).STRING
GLBMeshy API 작업의 고유 식별자로, 참조 또는 문제 해결에 사용할 수 있습니다.MESHY_TASK_ID
FBXGLB 파일 형식으로 생성된 3D 모델입니다.FILE3DGLB
FBXFBX 파일 형식으로 생성된 3D 모델입니다.FILE3DFBX
이 문서는 AI에 의해 생성되었습니다. 오류를 발견하거나 개선 제안이 있으시면 기여해 주세요! GitHub에서 편집

Source fingerprint (SHA-256): 134d9250d8b447bbbd2905f827e81b67f491ba355ebb93d4d256324b644100a2