Czym jest Hunyuan3D 2.0?

Krótka definicja: Hunyuan3D 2.0(*Hunyuan3D-2*) to dwuetapowy, wielkoskalowy system generatywny firmy Tencent do tworzenia wysokorozdzielczych teksturowanych zasobów 3D z wejść multimodalnych (tekst, 1–4 obrazy, szkice). System rozdziela generowanie kształtu (Hunyuan3D-DiT / ShapeVAE) i syntezę tekstur (Hunyuan3D-Paint), a także obejmuje produkcyjny interfejs/platformę (Hunyuan3D-Studio).

Główne funkcje

Wejścia multimodalne: Text-to-3D, image-to-3D (1–4 widoki), sketch-to-3D. Globalna strona i dokumentacja wyraźnie wymieniają te tryby.
Dwuetapowy pipeline:
1. Generowanie kształtu — Hunyuan3D-DiT (latent diffusion / flow-matching na latentach ShapeVAE) tworzy surową siatkę.
2. Synteza tekstur — Hunyuan3D-Paint generuje obrazy wielowidokowe uwarunkowane geometrią; wyniki są wypiekane do map tekstur o wysokiej rozdzielczości.
Formaty wyjściowe i integracja: Eksportuje popularne formaty 3D (OBJ, GLB) i został zaprojektowany do integracji z Unity, Unreal, Blenderem oraz standardowymi pipeline’ami produkcyjnymi. API dla przedsiębiorstw obsługuje generowanie materiałów PBR oraz opcje topologii (trójkąty/czworokąty).
Funkcje produkcyjne: Inteligentna topologia (optymalizacja siatki), stylizacja low-poly, wypiekanie tekstur oraz obsługa animacji w studio (szkieletowe skinning za pomocą GNN dla prostego retargetingu w Hunyuan3D-Studio).

Wydajność benchmarkowa (opublikowane metryki)

Z raportu technicznego / ewaluacji Hunyuan3D 2.0 (reprezentatywne metryki z Tabeli 4 artykułu; wyższy CLIP-score jest lepszy; niższe metryki CMMD / FID są lepsze):

Model	CMMD (↓)	FID_CLIP (↓)	FID_Inception (↓)	CLIP-score (↑)
Trellis (otwartoźródłowy model bazowy)	3.591	54.639	289.287	0.787
Model zamkniętoźródłowy 1	3.600	55.866	305.922	0.779
Model zamkniętoźródłowy 2	3.368	49.744	294.628	0.806
Model zamkniętoźródłowy 3	3.218	51.574	295.691	0.799
Hunyuan3D 2.0 (nasz)	3.193	49.165	282.429	0.809

Autorzy raportują lepszy poziom detali geometrii, wierność dopasowania do warunków wejściowych oraz jakość map tekstur zarówno w metrykach automatycznych, jak i w badaniu użytkowników obejmującym 300 przypadków (50 uczestników), w którym Hunyuan3D 2.0 przewyższył metody porównawcze pod względem jakości wizualnej i zgodności z obrazem warunkującym.

Reprezentatywne zastosowania produkcyjne

Generowanie zasobów do gier: szybkie prototypowanie rekwizytów, elementów otoczenia, siatek postaci lub obiektów low-poly i high-poly + wypieczone tekstury; moduł stylizacji low-poly Hunyuan3D + wypiekanie tekstur integrują się z pipeline’ami gier.
E-commerce 3D / wizualizacja produktów: przekształcanie zdjęć produktów lub szkiców w obracalne podglądy produktów 3D do katalogów.
Narzędzia kreatywne / studia: workflow szkic→3D dla artystów, automatyczne UV/wypiekanie tekstur oraz szybkie iteracje przy rozwijaniu wyglądu.
Treści AR/VR i szybkie prototypowanie: generowanie zasobów środowiskowych lub rekwizytów do immersyjnych doświadczeń, a następnie optymalizacja za pomocą stylizatora low-poly oraz modułów retargetingu/animacji.

Jak korzystać z Hunyuan3D 2.0

Krok 1: Zarejestruj się, aby uzyskać klucz API

Zaloguj się na cometapi.com. Jeśli nie jesteś jeszcze naszym użytkownikiem, najpierw się zarejestruj. Zaloguj się do swojej konsoli CometAPI. Uzyskaj poświadczenie dostępu, czyli klucz API interfejsu. Kliknij „Add Token” w sekcji tokena API w centrum osobistym, uzyskaj klucz tokena: sk-xxxxx i zatwierdź.

Krok 2: Wyślij żądania do API Hunyuan3D 2.0

Wybierz endpoint “"Hunyuan3D-2"”, aby wysłać żądanie API, i ustaw treść żądania. Metoda żądania i treść żądania są dostępne w dokumentacji API na naszej stronie. Dla wygody na naszej stronie dostępny jest również test Apifox. Zastąp <YOUR_API_KEY> swoim rzeczywistym kluczem CometAPI z konta. Bazowy URL to Hunyuan3D

Wstaw swoje żądanie i obraz do pola content — na to model odpowie. Przetwórz odpowiedź API, aby uzyskać wygenerowaną odpowiedź.

Hunyuan3D

Krok 3: Pobierz i zweryfikuj wyniki

Przetwórz odpowiedź API, aby uzyskać wygenerowaną odpowiedź. Po przetworzeniu API zwraca status zadania i dane wyjściowe.

Cennik dla Hunyuan3D

Poznaj konkurencyjne ceny dla Hunyuan3D, zaprojektowane tak, aby pasowały do różnych budżetów i potrzeb użytkowania. Nasze elastyczne plany zapewniają, że płacisz tylko za to, czego używasz, co ułatwia skalowanie w miarę wzrostu Twoich wymagań. Odkryj, jak Hunyuan3D może ulepszyć Twoje projekty przy jednoczesnym utrzymaniu kosztów na rozsądnym poziomie.

Cena Comet (USD / M Tokens)	Oficjalna cena (USD / M Tokens)	Zniżka
Na żądanie:$0.08	Na żądanie:$0.1	-20%

Przykładowy kod i API dla Hunyuan3D

Uzyskaj dostęp do kompleksowego przykładowego kodu i zasobów API dla Hunyuan3D, aby usprawnić proces integracji. Nasza szczegółowa dokumentacja zapewnia wskazówki krok po kroku, pomagając wykorzystać pełny potencjał Hunyuan3D w Twoich projektach.

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