Hunyuan3D 2.0란 무엇인가요?

간단한 정의: Hunyuan3D 2.0(*Hunyuan3D-2*)은 Tencent가 개발한 2단계 대규모 생성 시스템으로, 멀티모달 입력(텍스트, 1–4장의 이미지, 스케치)으로부터 고해상도 텍스처 3D 에셋을 생성합니다. 이 시스템은 형상 생성(Hunyuan3D-DiT / ShapeVAE)과 텍스처 합성(Hunyuan3D-Paint)을 분리하며, 프로덕션용 UI/플랫폼(Hunyuan3D-Studio)도 함께 제공합니다.

주요 기능

멀티모달 입력: 텍스트-투-3D, 이미지-투-3D(1–4개 뷰), 스케치-투-3D. 글로벌 사이트와 문서에서 이러한 모드를 명시적으로 나열하고 있습니다.
2단계 파이프라인:
1. 형상 생성 — Hunyuan3D-DiT(ShapeVAE 잠재값에 대한 latent diffusion / flow-matching)가 텍스처가 없는 기본 메시를 생성합니다.
2. 텍스처 합성 — Hunyuan3D-Paint가 형상 정보를 조건으로 멀티뷰 이미지를 생성하며, 출력 결과는 고해상도 텍스처 맵으로 베이킹됩니다.
출력 형식 및 통합: 일반적인 3D 형식(OBJ, GLB)으로 내보낼 수 있으며, Unity, Unreal, Blender 및 표준 프로덕션 파이프라인과의 통합을 염두에 두고 설계되었습니다. 엔터프라이즈 API는 PBR 머티리얼 생성과 토폴로지 옵션(삼각형/사각형)을 지원합니다.
프로덕션 기능: 스마트 토폴로지(메시 최적화), 로우폴리 스타일화, 텍스처 베이킹, 그리고 인스튜디오 애니메이션 지원(Hunyuan3D-Studio에서 간단한 리타기팅을 위한 GNN 기반 스켈레탈 스키닝).

벤치마크 성능 (공개 지표)

Hunyuan3D 2.0 기술 보고서 / 평가에서 발췌한 내용입니다(논문 Table 4의 대표 지표 기준; CLIP-score는 높을수록 좋고, CMMD / FID 지표는 낮을수록 좋습니다):

Model	CMMD (↓)	FID_CLIP (↓)	FID_Inception (↓)	CLIP-score (↑)
Trellis (open-source baseline)	3.591	54.639	289.287	0.787
Closed-source Model 1	3.600	55.866	305.922	0.779
Closed-source Model 2	3.368	49.744	294.628	0.806
Closed-source Model 3	3.218	51.574	295.691	0.799
Hunyuan3D 2.0 (Ours)	3.193	49.165	282.429	0.809

저자들은 자동 평가 지표 전반과 300개 사례, 50명 참가자로 구성된 사용자 연구에서 Hunyuan3D 2.0이 비교 방법들보다 기하 디테일, 조건 정렬 충실도, 텍스처 맵 품질 면에서 더 우수한 성능을 보였다고 보고했습니다.

대표적인 프로덕션 활용 사례

게임 에셋 생성: 프롭, 배경 오브젝트, 로우폴리 및 하이폴리 캐릭터 또는 프롭 메시와 베이크된 텍스처를 빠르게 프로토타이핑할 수 있습니다. Hunyuan3D의 로우폴리 스타일화 모듈과 텍스처 베이킹은 게임 파이프라인에 통합됩니다.
3D 이커머스 / 제품 시각화: 제품 사진이나 스케치를 회전 가능한 3D 제품 프리뷰로 변환하여 카탈로그에 활용할 수 있습니다.
크리에이티브 툴 / 스튜디오: 아티스트를 위한 스케치→3D 워크플로, 자동 UV/텍스처 베이킹, 룩 개발을 위한 빠른 반복 작업을 지원합니다.
AR/VR 콘텐츠 및 신속 프로토타이핑: 몰입형 경험을 위한 환경 에셋이나 프롭을 생성한 뒤, 로우폴리 스타일라이저와 리타기팅/애니메이션 모듈로 최적화할 수 있습니다.

Hunyuan3D 2.0 사용 방법

1단계: API 키 등록

cometapi.com에 로그인하세요. 아직 사용자가 아니라면 먼저 회원가입해 주세요. CometAPI console에 로그인합니다. 인터페이스의 액세스 자격 증명 API 키를 발급받으세요. 개인 센터의 API token에서 “Add Token”을 클릭하고 token key: sk-xxxxx를 발급받아 제출합니다.

2단계: Hunyuan3D 2.0 API에 요청 보내기

API 요청을 보내고 요청 본문을 설정하려면 “"Hunyuan3D-2"” 엔드포인트를 선택하세요. 요청 방식과 요청 본문은 당사 웹사이트의 API 문서에서 확인할 수 있습니다. 웹사이트에서는 편의를 위해 Apifox 테스트도 제공합니다. <YOUR_API_KEY>를 계정의 실제 CometAPI 키로 바꾸세요. base url은 Hunyuan3D입니다.

요청과 이미지를 content 필드에 삽입하세요. 이것이 모델이 응답할 내용입니다. API 응답을 처리하여 생성된 결과를 가져오세요.

Hunyuan3D

3단계: 결과 조회 및 확인

API 응답을 처리하여 생성된 결과를 가져오세요. 처리 후 API는 작업 상태와 출력 데이터를 반환합니다。

Hunyuan3D 가격

[모델명]의 경쟁력 있는 가격을 살펴보세요. 다양한 예산과 사용 요구에 맞게 설계되었습니다. 유연한 요금제로 사용한 만큼만 지불하므로 요구사항이 증가함에 따라 쉽게 확장할 수 있습니다. [모델명]이 비용을 관리 가능한 수준으로 유지하면서 프로젝트를 어떻게 향상시킬 수 있는지 알아보세요.

코멧 가격 (USD / M Tokens)	공식 가격 (USD / M Tokens)	할인
요청당:$0.08	요청당:$0.1	-20%

Hunyuan3D의 샘플 코드 및 API

[모델 이름]의 포괄적인 샘플 코드와 API 리소스에 액세스하여 통합 프로세스를 간소화하세요. 자세한 문서는 단계별 가이드를 제공하여 프로젝트에서 [모델 이름]의 모든 잠재력을 활용할 수 있도록 돕습니다.

Python
JavaScript
Curl

import os
import requests
import json

# Get your CometAPI key from https://api.cometapi.com/console/token
COMETAPI_KEY = os.environ.get("COMETAPI_KEY") or "<YOUR_COMETAPI_KEY>"
BASE_URL = "https://api.cometapi.com/v1"

# Create output/ folder
folder_path = "output"
os.makedirs(folder_path, exist_ok=True)

# Hunyuan3D-2: 3D model generation from image + prompt
response = requests.post(
    f"{BASE_URL}/images/generations",
    headers={
        "Authorization": f"Bearer {COMETAPI_KEY}",
        "Content-Type": "application/json"
    },
    json={
        "model": "Hunyuan3D-2",
        "prompt": "A cute baby sea otter",
        "image": "https://storage.fonedis.cc/attachments/1452236504373002446/1452848565021049034/ihliawhitne4_Cat_3af95b8a-adc8-4311-a8d8-0213853b1793.png?ex=694b4e2a&is=6949fcaa&hm=1a28b221a1619a82dfbcd041b32bc831d5d5c4da3fd42814ae4b7f43d80214b2"
    }
)

result = response.json()
print(json.dumps(result, indent=2))

# If the response contains a URL or data, save it
if "data" in result and len(result["data"]) > 0:
    data = result["data"][0]
    if "url" in data:
        print(f"
3D Model URL: {data['url']}")
    if "b64_json" in data:
        import base64
        # Save 3D model data if present
        model_data = base64.b64decode(data["b64_json"])
        output_path = os.path.join(folder_path, "hunyuan3d-2-output.glb")
        with open(output_path, "wb") as f:
            f.write(model_data)
        print(f"
3D Model saved to: {output_path}")

Python Code Example

import os
import requests
import json

# Get your CometAPI key from https://api.cometapi.com/console/token
COMETAPI_KEY = os.environ.get("COMETAPI_KEY") or "<YOUR_COMETAPI_KEY>"
BASE_URL = "https://api.cometapi.com/v1"

# Create output/ folder
folder_path = "output"
os.makedirs(folder_path, exist_ok=True)

# Hunyuan3D-2: 3D model generation from image + prompt
response = requests.post(
    f"{BASE_URL}/images/generations",
    headers={
        "Authorization": f"Bearer {COMETAPI_KEY}",
        "Content-Type": "application/json"
    },
    json={
        "model": "Hunyuan3D-2",
        "prompt": "A cute baby sea otter",
        "image": "https://storage.fonedis.cc/attachments/1452236504373002446/1452848565021049034/ihliawhitne4_Cat_3af95b8a-adc8-4311-a8d8-0213853b1793.png?ex=694b4e2a&is=6949fcaa&hm=1a28b221a1619a82dfbcd041b32bc831d5d5c4da3fd42814ae4b7f43d80214b2"
    }
)

result = response.json()
print(json.dumps(result, indent=2))

# If the response contains a URL or data, save it
if "data" in result and len(result["data"]) > 0:
    data = result["data"][0]
    if "url" in data:
        print(f"\n3D Model URL: {data['url']}")
    if "b64_json" in data:
        import base64
        # Save 3D model data if present
        model_data = base64.b64decode(data["b64_json"])
        output_path = os.path.join(folder_path, "hunyuan3d-2-output.glb")
        with open(output_path, "wb") as f:
            f.write(model_data)
        print(f"\n3D Model saved to: {output_path}")

JavaScript Code Example

import fs from "fs";
import path from "path";
import { fileURLToPath } from "url";

const __dirname = path.dirname(fileURLToPath(import.meta.url));

// Get your CometAPI key from https://api.cometapi.com/console/token
const COMETAPI_KEY = process.env.COMETAPI_KEY || "<YOUR_COMETAPI_KEY>";
const BASE_URL = "https://api.cometapi.com/v1";

// Create output/ folder
const folderPath = path.join(__dirname, "../output");
if (!fs.existsSync(folderPath)) {
  fs.mkdirSync(folderPath, { recursive: true });
}

// Hunyuan3D-2: 3D model generation from image + prompt
async function generateModel() {
  const response = await fetch(`${BASE_URL}/images/generations`, {
    method: "POST",
    headers: {
      Authorization: `Bearer ${COMETAPI_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      model: "Hunyuan3D-2",
      prompt: "A cute baby sea otter",
      image:
        "https://storage.fonedis.cc/attachments/1452236504373002446/1452848565021049034/ihliawhitne4_Cat_3af95b8a-adc8-4311-a8d8-0213853b1793.png?ex=694b4e2a&is=6949fcaa&hm=1a28b221a1619a82dfbcd041b32bc831d5d5c4da3fd42814ae4b7f43d80214b2",
    }),
  });

  const result = await response.json();
  console.log(JSON.stringify(result, null, 2));

  // If the response contains a URL or data, save it
  if (result.data && result.data.length > 0) {
    const data = result.data[0];
    if (data.url) {
      console.log(`\n3D Model URL: ${data.url}`);
    }
    if (data.b64_json) {
      // Save 3D model data if present
      const modelData = Buffer.from(data.b64_json, "base64");
      const outputPath = path.join(folderPath, "hunyuan3d-2-output.glb");
      fs.writeFileSync(outputPath, modelData);
      console.log(`\n3D Model saved to: ${outputPath}`);
    }
  }
}

generateModel().catch(console.error);

Curl Code Example

#!/bin/bash

# Get your CometAPI key from https://api.cometapi.com/console/token
COMETAPI_KEY="${COMETAPI_KEY:-<YOUR_COMETAPI_KEY>}"

# Create output/ folder
mkdir -p output

# Hunyuan3D-2: 3D model generation from image + prompt
curl --location --request POST 'https://api.cometapi.com/v1/images/generations' \
  --header "Authorization: Bearer $COMETAPI_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
    "model": "Hunyuan3D-2",
    "prompt": "A cute baby sea otter",
    "image": "https://storage.fonedis.cc/attachments/1452236504373002446/1452848565021049034/ihliawhitne4_Cat_3af95b8a-adc8-4311-a8d8-0213853b1793.png?ex=694b4e2a&is=6949fcaa&hm=1a28b221a1619a82dfbcd041b32bc831d5d5c4da3fd42814ae4b7f43d80214b2"
}'