Official Hi3D v1.0: high-resolution 3D geometry refinement built on Sparc3D. Inference code, model weights, and documentation.

Hi3D v1.0 — 기능 소개

Hi3D v1.0은 3D 지오메트리 정교화 도구입니다. 다음 두 가지를 입력으로 사용합니다:

거친 3D 메쉬 (객체의 대략적이고 낮은 디테일의 3D 모델)
해당 객체의 참조 이미지

이 도구는 고해상도의 더 상세한 3D 메쉬를 생성하며, 층을 이룬 부조, 건축 몰딩, 곡선 경계, 비늘, 치아, 동심원 홈과 같은 미세한 표면 디테일을 추가합니다.

이 도구는 이전 시스템인 Sparc3D를 기반으로 구축되었으며, 호환성을 위해 Sparc3D의 내부 명칭(sparc3d, Sparc3DPipeline)을 유지합니다.

작동 원리

시스템은 패스(Pass) 단위로 작동합니다. 각 패스는 메쉬를 더 높은 해상도로 정교화합니다:

패스	구조 그리드	추출 그리드
1	64³	512³
2	128³	1024³
3	192³	1536³

512³ 요청은 1개의 패스를 실행합니다.
1024³ 요청은 2개의 패스를 실행합니다.
1536³ 요청은 3개의 패스를 모두 실행합니다.

각 패스에서는 희소 데이터 포인트를 샘플링하고, 신경망으로 디코딩하여 메쉬를 추출한 다음, 다음 패스에 공급하기 위해 해당 메쉬를 재복셀화(재그리드화)합니다. 참조 이미지는 전체 과정에서 정교화를 안내합니다.

결과물

지오메트리 전용. 텍스처, 재질, 정점 색상은 포함되지 않습니다.
출력물은 재중심화 및 정규화되어 단위 최대 반경으로 조정됩니다. 원래의 월드 좌표와 스케일은 유지되지 않습니다.
숨겨진 표면(이미지에서 보이지 않는 부분)은 그럴듯한 보완이며, 정확한 재구성이 아닙니다.

요구 사항

Linux, Python 3.10
NVIDIA GPU (컴퓨트 능력 8.0 이상, 예: H20, A100급)
CUDA toolkit 12.0–12.5
CPU 추론 경로 없음
1536³ 설정은 96 GB NVIDIA H20에서만 검증되었습니다. 더 작은 GPU에서의 메모리 요구 사항은 알려지지 않았습니다.

포함된 항목 / 포함되지 않은 항목

포함:

추론 코드 (Python 패키지 + 명령줄 도구)
Hugging Face의 모델 아티팩트 (8개 파일: 설정 + 모델 가중치)
Hunyuan3D-2 mini(타사 거친 메쉬 생성기)용 선택적 어댑터

포함되지 않음:

학습 코드
논문의 평가용 하네스
벤치마크 분할 또는 비교용 메쉬

사용 방법

Python API:

from PIL import Image
import trimesh
from sparc3d import Sparc3DPipeline

pipeline = Sparc3DPipeline.from_pretrained(
    "hi3d-official/Hi3Dv1.0",
).to("cuda")

result = pipeline(
    Image.open("input.png"),
    trimesh.load("coarse.glb", force="mesh", process=False),
    resolution=1024,
    num_inference_steps=25,
    seed=0,
)
result.mesh.export("refined.glb")

지원 해상도: 512, 1024, 1536. 기본값: 패스당 25회 스케줄러 업데이트.

명령줄:

python demo/refine_mesh.py \
  --model hi3d-official/Hi3Dv1.0 \
  --image input.png --coarse-mesh coarse.glb --output refined.glb \
  --resolution 1024 --num-inference-steps 25 --seed 0

주요 제한 사항 및 주의 사항

거친 구조가 중요합니다. 입력 메쉬의 심각한 오류는 출력물에도 남을 수 있습니다.
시드값은 보장이 아닙니다. GPU 작업은 비트 단위로 결정적이지 않습니다. 동일한 시드와 입력으로도 약간 다른 메쉬가 생성될 수 있습니다.
GPU 커널이 필수입니다. flash-attn은 대체 경로가 없으며 성공적으로 컴파일되어야 합니다.
해상도는 요청일 뿐 보장이 아닙니다. 목표 해상도에 도달할 수 없는 경우, 코드는 낮은 품질의 결과를 조용히 반환하는 대신 오류를 발생시킵니다.
배경 제거는 선택 사항입니다 (demo 추가 패키지 설치 필요).

라이선스 및 상업적 조건

Hi3D Open License Agreement Version 1.0을 따릅니다:

상업적 이용이 허용됩니다.
이 도구를 사용하는 제품이 월간 활성 사용자 수 200,000명 또는 월간 수익 1,000,000달러를 초과하는 경우, 라이선스 제공자에게 통지하고 60일 이내에 별도의 서면 라이선스를 신청해야 합니다.
상업적 통합 시 공식 웹사이트로 연결되는 "Powered by Hi3D 1.0" 문구를 표시해야 합니다.
독립형 출력물(Hi3D 재질이나 모델 파생물을 포함하지 않는 메쉬)은 브랜드 표시나 규모 기반 라이선스 의무를 트리거하지 않습니다.
기존 Apache-2.0 및 MIT 조항은 원본/타사 부분에 계속 적용됩니다.
타사 구성 요소(Hunyuan3D-2, DINOv2, CLIP)는 각자의 라이선스를 유지합니다.

요약 정보

출시일: 2026년 10월 23일
학습 데이터: 약 200만 개의 큐레이션된 3D 에셋 (기술 보고서 기준)
라이브 데모: Hugging Face Spaces에서 이용 가능
문의: contact@hi3d.ai

hi3d-official/Hi3Dv1.0