Che cos'è Hunyuan3D 2.0?

Definizione breve: Hunyuan3D 2.0(*Hunyuan3D-2*) è un sistema generativo su larga scala a due fasi di Tencent per produrre asset 3D texturizzati ad alta risoluzione da input multimodali (testo, 1–4 immagini, schizzi). Il sistema separa la generazione della forma (Hunyuan3D-DiT / ShapeVAE) e la sintesi della texture (Hunyuan3D-Paint), oltre a un'interfaccia/piattaforma di produzione (Hunyuan3D-Studio).

Caratteristiche principali

Input multimodali: da testo a 3D, da immagine a 3D (1–4 viste), da schizzo a 3D. Il sito globale e la documentazione elencano esplicitamente queste modalità.
Pipeline a due fasi:
1. Generazione della forma — Hunyuan3D-DiT (diffusione latente / flow-matching sui latenti di ShapeVAE) produce una mesh grezza.
2. Sintesi della texture — Hunyuan3D-Paint genera immagini multi-vista condizionate dalla geometria; gli output vengono sottoposti a baking in mappe di texture ad alta risoluzione.
Formati di output e integrazione: Esporta formati 3D comuni (OBJ, GLB) ed è progettato per integrarsi con Unity, Unreal, Blender e pipeline di produzione standard. L'API Enterprise supporta la generazione di materiali PBR e opzioni di topologia (triangoli/quadrilateri).
Funzionalità di produzione: Topologia intelligente (ottimizzazione della mesh), stilizzazione low-poly, texture baking e supporto all'animazione in studio (skinning scheletrico via GNN per un semplice retargeting in Hunyuan3D-Studio).

Prestazioni di benchmark (metriche pubblicate)

Dal rapporto tecnico/valutazione di Hunyuan3D 2.0 (metriche rappresentative dalla Tabella 4 dell'articolo; un CLIP-score più alto è migliore; metriche CMMD / FID più basse sono migliori):

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

Gli autori riportano un superiore livello di dettaglio geometrico, fedeltà di allineamento alla condizione e qualità delle mappe di texture, sia sulle metriche automatiche sia in uno studio utente su 300 casi (50 partecipanti) in cui Hunyuan3D 2.0 ha superato i metodi comparativi in termini di qualità visiva e aderenza all'immagine condizionale.

Casi d'uso rappresentativi in produzione

Generazione di asset per giochi: prototipazione rapida di oggetti di scena, elementi di set, mesh di personaggi o oggetti low- e high-poly + texture bake; il modulo di stilizzazione low-poly di Hunyuan3D + il texture baking si integrano nelle pipeline di gioco.
E-commerce 3D / visualizzazione di prodotto: convertire foto di prodotto o schizzi in anteprime 3D ruotabili per i cataloghi.
Strumenti creativi / studi: flussi di lavoro schizzo→3D per artisti, UV/texture baking automatici e iterazione rapida per lo sviluppo del look.
Contenuti AR/VR e prototipazione rapida: generare asset ambientali o oggetti per esperienze immersive, quindi ottimizzarli tramite lo stilizzatore low-poly e i moduli di retargeting/animazione.

Come usare Hunyuan3D 2.0

Passaggio 1: Registrati per la chiave API

Accedi a cometapi.com. Se non sei ancora nostro utente, registrati prima. Accedi alla tua console CometAPI. Ottieni la chiave API delle credenziali di accesso dell'interfaccia. Clicca “Add Token” nel token API nel centro personale, ottieni la chiave del token: sk-xxxxx e invia.

Passaggio 2: Invia richieste all'API Hunyuan3D 2.0

Seleziona l'endpoint “"Hunyuan3D-2"” per inviare la richiesta API e imposta il corpo della richiesta. Il metodo e il corpo della richiesta sono reperibili nella documentazione API sul nostro sito. Il nostro sito fornisce anche un test Apifox per tua comodità. Sostituisci <YOUR_API_KEY> con la tua effettiva chiave CometAPI del tuo account. l'URL di base è Hunyuan3D

Inserisci la tua richiesta e l'immagine nel campo content—è a questo che il modello risponderà . Elabora la risposta dell'API per ottenere la risposta generata.

Hunyuan3D

Passaggio 3: Recupera e verifica i risultati

Elabora la risposta dell'API per ottenere la risposta generata. Dopo l'elaborazione, l'API risponde con lo stato dell'attività e i dati di output.

Prezzi per Hunyuan3D

Esplora i prezzi competitivi per Hunyuan3D, progettato per adattarsi a vari budget e necessità di utilizzo. I nostri piani flessibili garantiscono che paghi solo per quello che usi, rendendo facile scalare man mano che i tuoi requisiti crescono. Scopri come Hunyuan3D può migliorare i tuoi progetti mantenendo i costi gestibili.

Prezzo Comet (USD / M Tokens)	Prezzo Ufficiale (USD / M Tokens)	Sconto
Per Richiesta:$0.08	Per Richiesta:$0.1	-20%

Codice di esempio e API per Hunyuan3D

Accedi a codice di esempio completo e risorse API per Hunyuan3D per semplificare il tuo processo di integrazione. La nostra documentazione dettagliata fornisce una guida passo dopo passo, aiutandoti a sfruttare appieno il potenziale di Hunyuan3D nei tuoi progetti.

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