什麼是 Hunyuan3D 2.0？

簡短定義： Hunyuan3D 2.0(*Hunyuan3D-2*) 是騰訊推出的兩階段大型生成系統，可從多模態輸入（文字、1–4 張圖片、草圖）生成高解析度、具貼圖的 3D 資產。系統將形狀生成（Hunyuan3D-DiT / ShapeVAE）與材質合成（Hunyuan3D-Paint）分離，並配備生產級 UI/平台（Hunyuan3D-Studio）。

主要功能

多模態輸入： Text-to-3D、Image-to-3D（1–4 視圖）、Sketch-to-3D。官方網站與文件明確列出這些模式。
兩階段管線：
1. 形狀生成 — Hunyuan3D-DiT（在 ShapeVAE 潛空間上的潛空間擴散 / 流匹配）生成裸網格。
2. 材質合成 — Hunyuan3D-Paint 在幾何條件下生成多視圖圖像；輸出烘焙為高解析度材質貼圖。
輸出格式與整合： 匯出常見 3D 格式（OBJ、GLB），並設計可與 Unity、Unreal、Blender 及標準生產管線整合。企業級 API 支援 PBR 材質生成與拓撲選項（三角形/四邊形）。
生產特性： 智慧拓撲（網格優化）、低多邊形風格化、貼圖烘焙，以及工作室內的動畫支援（在 Hunyuan3D-Studio 中透過 GNN 進行骨架蒙皮以實現簡單的動作重定向）。

基準表現（已發表指標）

來自 Hunyuan3D 2.0 技術報告/評測（論文表 4 的代表性指標；CLIP-score 越高越好；CMMD / FID 越低越好）：

模型	CMMD (↓)	FID_CLIP (↓)	FID_Inception (↓)	CLIP-score (↑)
Trellis（開源基線）	3.591	54.639	289.287	0.787
閉源模型 1	3.600	55.866	305.922	0.779
閉源模型 2	3.368	49.744	294.628	0.806
閉源模型 3	3.218	51.574	295.691	0.799
Hunyuan3D 2.0（本方法）	3.193	49.165	282.429	0.809

作者報告在自動化指標與一項包含 300 個案例（50 名參與者）的用戶研究中，Hunyuan3D 2.0 在幾何細節、條件對齊保真度與貼圖品質方面表現優異，並在視覺品質與對條件圖像的遵從性上優於對比方法。

代表性生產級用例

遊戲資產生成： 快速製作道具、場景構件，低/高多邊形角色或道具網格與烘焙貼圖；Hunyuan3D 的低多邊形風格化模組與貼圖烘焙可無縫整合進遊戲管線。
3D 電商/產品可視化： 將產品照片或草圖轉換為用於型錄的可旋轉 3D 產品預覽。
創作工具/工作室： 草圖→3D 的藝術家工作流程、UV/貼圖自動烘焙，以及外觀開發的快速迭代。
AR/VR 內容與快速原型： 生成沉浸式體驗的環境資產或道具，之後透過低多邊形風格化與重定向/動畫模組進行優化。

如何使用 Hunyuan3D 2.0

步驟一：申請 API 金鑰

登入 cometapi.com。若您尚未成為用戶，請先註冊。登入您的 CometAPI 控制台。取得介面的存取憑證 API 金鑰。在個人中心的 API token 中點擊“Add Token”，取得 token 金鑰：sk-xxxxx 並提交。

步驟二：向 Hunyuan3D 2.0 API 發送請求

選擇 “"Hunyuan3D-2"” 端點發送 API 請求，並設定請求體。請求方法與請求體可從我們的網站 API 文件獲取。我們的網站也提供 Apifox 測試以方便使用。將 <YOUR_API_KEY> 替換為您帳戶中的實際 CometAPI 金鑰。base url is Hunyuan3D

將您的請求與圖片插入 content 欄位——模型將回應該內容。處理 API 回應以獲得生成結果。

Hunyuan3D

步驟三：取得並驗證結果

處理 API 回應以獲得生成結果。處理後，API 會返回任務狀態與輸出資料。

Hunyuan3D 的範例程式碼和 API

存取完整的範例程式碼和 API 資源，以簡化您的 Hunyuan3D 整合流程。我們詳盡的文件提供逐步指引，協助您在專案中充分發揮 Hunyuan3D 的潛力。

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