Hunyuan3D 2.0 là gì?

Định nghĩa ngắn: Hunyuan3D 2.0(*Hunyuan3D-2*) là một hệ thống tạo sinh quy mô lớn gồm hai giai đoạn của Tencent, dùng để tạo ra các tài sản 3D có kết cấu độ phân giải cao từ đầu vào đa phương thức (văn bản, 1–4 hình ảnh, bản phác thảo). Hệ thống tách riêng tạo hình dạng (Hunyuan3D-DiT / ShapeVAE) và tổng hợp kết cấu (Hunyuan3D-Paint), đồng thời có thêm giao diện/nền tảng sản xuất (Hunyuan3D-Studio).

Các tính năng chính

Đầu vào đa phương thức: Text-to-3D, image-to-3D (1–4 góc nhìn), sketch-to-3D. Trang web toàn cầu và tài liệu đều liệt kê rõ các chế độ này.
Quy trình hai giai đoạn:
1. Tạo hình dạng — Hunyuan3D-DiT (khuếch tán tiềm ẩn / flow-matching trên các latent của ShapeVAE) tạo ra một lưới thô.
2. Tổng hợp kết cấu — Hunyuan3D-Paint tạo ảnh đa góc nhìn có điều kiện theo hình học; đầu ra được bake thành các bản đồ kết cấu độ phân giải cao.
Định dạng đầu ra & tích hợp: Xuất các định dạng 3D phổ biến (OBJ, GLB) và được thiết kế để tích hợp với Unity, Unreal, Blender cùng các quy trình sản xuất tiêu chuẩn. API doanh nghiệp hỗ trợ tạo vật liệu PBR và các tùy chọn topology (tam giác/tứ giác).
Tính năng sản xuất: Topology thông minh (tối ưu hóa lưới), tạo kiểu low-poly, texture baking và hỗ trợ hoạt ảnh ngay trong studio (skeletal skinning qua GNN để retargeting đơn giản trong Hunyuan3D-Studio).

Hiệu năng benchmark (các chỉ số đã công bố)

Từ báo cáo kỹ thuật / đánh giá của Hunyuan3D 2.0 (các chỉ số tiêu biểu từ Bảng 4 của bài báo; CLIP-score cao hơn là tốt hơn; các chỉ số CMMD / FID thấp hơn là tốt hơn):

Model	CMMD (↓)	FID_CLIP (↓)	FID_Inception (↓)	CLIP-score (↑)
Trellis (baseline mã nguồn mở)	3.591	54.639	289.287	0.787
Mô hình mã nguồn đóng 1	3.600	55.866	305.922	0.779
Mô hình mã nguồn đóng 2	3.368	49.744	294.628	0.806
Mô hình mã nguồn đóng 3	3.218	51.574	295.691	0.799
Hunyuan3D 2.0 (Của chúng tôi)	3.193	49.165	282.429	0.809

Các tác giả báo cáo rằng hệ thống vượt trội về chi tiết hình học, độ trung thực trong việc bám sát điều kiện đầu vào và chất lượng bản đồ kết cấu qua cả các chỉ số tự động lẫn một nghiên cứu người dùng với 300 trường hợp (50 người tham gia), trong đó Hunyuan3D 2.0 vượt qua các phương pháp so sánh về chất lượng hình ảnh và mức độ bám sát hình ảnh điều kiện.

Các trường hợp sử dụng sản xuất tiêu biểu

Tạo tài sản game: tạo mẫu nhanh cho đạo cụ, bối cảnh, nhân vật hoặc lưới đạo cụ low-poly và high-poly + kết cấu đã bake; mô-đun tạo kiểu low-poly + texture baking của Hunyuan3D tích hợp vào pipeline game.
Thương mại điện tử 3D / trực quan hóa sản phẩm: chuyển ảnh sản phẩm hoặc bản phác thảo thành bản xem trước sản phẩm 3D có thể xoay cho danh mục.
Công cụ sáng tạo / studio: quy trình sketch→3D cho nghệ sĩ, bake UV/texture tự động và lặp nhanh cho quá trình phát triển diện mạo.
Nội dung AR/VR & tạo mẫu nhanh: tạo tài sản môi trường hoặc đạo cụ cho các trải nghiệm nhập vai, sau đó tối ưu bằng mô-đun tạo kiểu low-poly và các mô-đun retargeting/animation.

Cách sử dụng Hunyuan3D 2.0

Bước 1: Đăng ký API Key

Đăng nhập vào cometapi.com. Nếu bạn chưa là người dùng của chúng tôi, vui lòng đăng ký trước. Đăng nhập vào bảng điều khiển CometAPI của bạn. Lấy API key thông tin xác thực truy cập của giao diện. Nhấp vào “Add Token” tại mục API token trong trung tâm cá nhân, lấy token key: sk-xxxxx và gửi đi.

Bước 2: Gửi yêu cầu tới API Hunyuan3D 2.0

Chọn endpoint “"Hunyuan3D-2"” để gửi yêu cầu API và thiết lập request body. Phương thức request và request body được cung cấp trong tài liệu API trên website của chúng tôi. Website của chúng tôi cũng cung cấp bài kiểm tra Apifox để thuận tiện cho bạn. Thay thế <YOUR_API_KEY> bằng CometAPI key thực tế từ tài khoản của bạn. base url là Hunyuan3D

Chèn request và hình ảnh của bạn vào trường content—đây là nội dung mà mô hình sẽ phản hồi. Xử lý phản hồi API để nhận câu trả lời được tạo ra.

Hunyuan3D

Bước 3: Truy xuất và xác minh kết quả

Xử lý phản hồi API để nhận câu trả lời được tạo ra. Sau khi xử lý, API sẽ phản hồi với trạng thái tác vụ và dữ liệu đầu ra.

Giá cả cho Hunyuan3D

Khám phá mức giá cạnh tranh cho Hunyuan3D, được thiết kế để phù hợp với nhiều ngân sách và nhu cầu sử dụng khác nhau. Các gói linh hoạt của chúng tôi đảm bảo bạn chỉ trả tiền cho những gì bạn sử dụng, giúp dễ dàng mở rộng quy mô khi yêu cầu của bạn tăng lên. Khám phá cách Hunyuan3D có thể nâng cao các dự án của bạn trong khi vẫn kiểm soát được chi phí.

Giá Comet (USD / M Tokens)	Giá Chính Thức (USD / M Tokens)	Giảm giá
Theo Yêu cầu:$0.08	Theo Yêu cầu:$0.1	-20%

Mã mẫu và API cho Hunyuan3D

Truy cập mã mẫu toàn diện và tài nguyên API cho Hunyuan3D để tối ưu hóa quy trình tích hợp của bạn. Tài liệu chi tiết của chúng tôi cung cấp hướng dẫn từng bước, giúp bạn khai thác toàn bộ tiềm năng của Hunyuan3D trong các dự án của mình.

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"
}'