Hunyuan3D 2.0 деген не?

Қысқаша анықтама: Hunyuan3D 2.0(*Hunyuan3D-2*) — Tencent компаниясының мәтін, 1–4 сурет және эскиз сияқты көпмодальды енгізулерден жоғары айқындығы бар текстураланған 3D ассеттерді өндіруге арналған екі кезеңді, ауқымды генеративті жүйесі. Жүйе процесті бөліп ұйымдастырады: пішін генерациясы (Hunyuan3D-DiT / ShapeVAE) және текстура синтезі (Hunyuan3D-Paint), сондай-ақ өндірістік UI/платформа (Hunyuan3D-Studio).

Негізгі мүмкіндіктер

Көпмодальды енгізулер: мәтіннен 3D-ға, суреттен 3D-ға (1–4 көрініс), эскизден 3D-ға. Ғаламдық сайтта және құжаттамада бұл режимдер анық көрсетілген.
Екі кезеңді пайплайн:
1. Пішін генерациясы — Hunyuan3D-DiT (ShapeVAE латенттерінде latent diffusion / flow-matching) жалаң тор жасайды.
2. Текстура синтезі — Hunyuan3D-Paint геометрияға шартталған көп көріністі суреттерді тудырады; нәтижелер жоғары айқындығы бар текстура карталарына пісіріледі.
Шығыс форматтары және ықпалдасу: Кең таралған 3D форматтарға экспорттайды (OBJ, GLB) және Unity, Unreal, Blender және стандартты өндірістік пайплайндармен интеграцияға арналған. Enterprise API PBR материалдарын генерациялауды және топология опцияларын (үшбұрыштар/квадарлар) қолдайды.
Өндірістік функциялар: ақылды топология (торды оңтайландыру), low-poly стильдеу, текстураларды пісіру және студия ішіндегі анимацияға қолдау (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 2.0 көрнекі сапа және шартты кескінге сәйкестік тұрғысынан салыстырмалы әдістерден озып түсті.

Типтік өндірістік қолдану жағдайлары

Ойын ассеттерін генерациялау: реквизиттер, сахналық элементтер, low- және high-poly кейіпкер/реквизит торларын және пісірілген текстураларды жылдам прототиптеу; Hunyuan3D-дің low-poly стильдеу модулі және текстураларды пісіру ойын пайплайндарына интеграцияланады.
3D e-commerce / өнімді визуализациялау: өнім фотоларын немесе эскиздерін каталогтар үшін айналдырылатын 3D алдын ала қарауларға түрлендіру.
Шығармашылық құралдар / студиялар: sketch→3D жұмыс ағындары, автоматты UV/текстураны пісіру және визуалды көріністі әзірлеу үшін жедел итерация.
AR/VR контенті және жедел прототиптеу: иммерсивті тәжірибелерге арналған орта ассеттерін немесе реквизиттерді генерациялау, содан кейін low-poly стильдегіш және ретаргетинг/анимация модульдері арқылы оңтайландыру.

Hunyuan3D 2.0 қалай пайдалану керек

1-қадам: API кілтін алу үшін тіркелу

cometapi.com сайтына кіріңіз. Егер сіз әлі біздің пайдаланушы болмасаңыз, алдымен тіркеліңіз. CometAPI console консоліне кіріңіз. Интерфейске қолжетімділік беретін API кілтін алыңыз. Жеке кабинеттегі API token бөлімінде “Add Token” түймесін басып, токен кілтін алыңыз: sk-xxxxx және жіберіңіз.

2-қадам: Hunyuan3D 2.0 API қызметіне сұраулар жіберу

API сұрауын жіберу және сұрау денесін орнату үшін “"Hunyuan3D-2"” endpoint таңдаңыз. Сұрау әдісі мен сұрау денесі біздің веб-сайттағы API құжатынан алынады. Қолайлылық үшін веб-сайтта Apifox сынағы да ұсынылады. <YOUR_API_KEY> мәнін аккаунтыңыздағы нақты CometAPI кілтімен алмастырыңыз. базалық 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"
}'