Hunyuan3D 2.1이 GLB를 반환해도 텍스처 단계의 실패 여부는 확인해야 한다

Hunyuan3D 2.1의 공식 워커 프로세스는 텍스처 생성에 실패하면 텍스처 없는 메시로 대체한다. 형태, 텍스처, 대상 장면으로의 가져오기를 각각 검수해야 ‘파일이 있다’는 사실을 납품 가능한 에셋으로 오인하지 않을 수 있다.

출처: github.com
2026년 11월 11일
5 min

팀에서 참고 이미지 한 장을 데모 장면에 배치할 정적 소품으로 만들 때 Tencent Hunyuan 3D는 초기 메시와 텍스처 생성을 맡을 수 있다. 하지만 이를 작업 과정에 연결할 때 완료 기준은 GLB 파일을 다운로드했는지가 아니라 대상 장면에서 실제로 사용할 에셋이어야 한다. 이 글은 공식 오픈소스 Hunyuan3D 2.1의 코드를 바탕으로 검수 절차를 설계했다. 생성 테스트를 실행하지 않았으며, 이 버전의 동작을 모든 호스팅 서비스에 적용하지도 않는다.

공식 model_worker.py에는 놓치기 쉬운 분기가 있다. 먼저 텍스처 없는 메시를 내보낸 뒤 텍스처 생성과 형식 변환을 시도한다. 텍스처 단계에서 예외가 발생하면 처음의 텍스처 없는 메시를 최종 경로로 반환한다. 따라서 후속 처리에서 파일을 받았더라도 기대한 텍스처 적용 완성본을 얻지 못했을 수 있다. 자동화에 연결할 때는 작업 로그와 단계별 결과를 저장하고, ‘지오메트리 생성 성공’과 ‘텍스처 생성 성공’을 별도로 기록해야 한다.

형태를 먼저 확인한 뒤 텍스처 처리에 자원을 투입하자

데모용 탁상 장식품을 만든다고 가정해 보자. 먼저 사용할 권리가 있는 참고 이미지를 준비하고 반드시 유지해야 할 윤곽 특징을 적는다. 공식 demo.py는 두 단계의 경로를 보여준다. 형태 파이프라인이 메시를 생성해 demo.glb로 내보내고, 이어서 텍스처 파이프라인이 메시 경로와 참고 이미지를 받아 demo_textured.glb를 출력한다. 단계별로 나누어 확인할 지점을 제공하지만, 예제 자체가 해당 에셋이 자신의 장면에 적합함을 입증하지는 않는다.

먼저 텍스처 없는 뷰에서 모델을 돌려 앞면, 옆면, 뒷면을 보며 윤곽, 얇은 부분, 바닥을 확인하는 것이 좋다. 참고 이미지에 보이지 않는 부위는 특히 사람의 판단이 필요하다. 형태가 요구 사항을 충족하지 못하면 참고 자료나 모델 수정 단계로 돌아가야 한다. 텍스처를 입히면 구조가 바로잡힐 것이라고 기대해서는 안 된다. 형태가 검수를 통과한 뒤에만 재질 처리를 진행하고, 재작업의 원인을 찾기 쉽도록 두 단계의 파일을 각각 보관한다.

로컬에서 실행하기 전에는 자원도 확인해야 한다. 저장소 README에 기재된 GPU 메모리 요구량은 형태 생성 10GB, 텍스처 생성 21GB, 전체 처리 과정 29GB다. 이는 공식 환경 안내이며 이 글에서 측정한 최대 사용량이 아니다. 형태 생성 단계가 실행된다고 해서 전체 과정을 실행할 수 있다는 뜻은 아니다. 일괄 처리 생산량을 약속하기 전에 배포 담당자가 사용하는 버전과 실제 하드웨어를 기준으로 전체 처리 경로를 검증하도록 해야 한다.

인계할 때 파일뿐 아니라 장면을 검증하자

텍스처 단계가 끝나면 결과물을 열어 재질이 실제로 존재하는지 확인한다. 로그에 대체 결과로 돌아갔다는 기록이 있다면 납품 완료가 아니라 텍스처 보완 대기로 표시해야 한다. 이어서 실제 사용하는 편집기나 엔진에 에셋을 가져와 대상 조명에서 외관, 크기 비율, 방향을 확인하고, 인수 담당자에게 폴리곤 수 줄이기, 콜라이더 또는 다른 가공이 더 필요한지 확인받는다. 이는 권장하는 납품 점검 항목이며 코드가 자동으로 수행하는 검수가 아니다.

정적 소품의 초안을 빠르게 얻어야 하는 팀에는 이러한 단계별 과정이 실패한 작업을 적절한 지점에서 멈추게 해 준다. 바로 리깅해 애니메이션에 사용할 수 있는 캐릭터, 치수가 정확한 부품, 기존 토폴로지 규칙에 맞는 모델을 납품해야 한다면 생성 파일만으로는 기준 충족을 확인할 수 없다. 별도의 모델링과 기술 검수 단계를 유지해야 한다. 정식 사용 전에는 사용하는 모델 버전의 라이선스와 참고 자료의 권리도 확인해야 한다. 먼저 에셋 하나가 생성, 점검, 가져오기, 인수의 전 과정을 통과하게 한 뒤 일괄 작업으로 확대할지 결정하자.

콘텐츠 안내:이 글은 공개 자료를 바탕으로 정리한 도구 선택 참고 자료입니다. 제품 기능, 가격 및 관련 정책은 수시로 변경될 수 있으니 최신 공식 정보를 확인해 주세요.

원문 출처:github.com