Hva er Hunyuan3D 2.0?

Kort definisjon: Hunyuan3D 2.0(*Hunyuan3D-2*) er et totrinns generativt system i stor skala fra Tencent for å produsere høyoppløselige teksturerte 3D-objekter fra multimodale inndata (tekst, 1–4 bilder, skisser). Systemet skiller mellom formgenerering (Hunyuan3D-DiT / ShapeVAE) og tekstursyntese (Hunyuan3D-Paint), samt et produksjonsgrensesnitt/en plattform (Hunyuan3D-Studio).

Hovedfunksjoner

Multimodale inndata: Tekst-til-3D, bilde-til-3D (1–4 visninger), skisse-til-3D. Det globale nettstedet og dokumentasjonen lister eksplisitt opp disse modusene.
Totrinns pipeline:
1. Formgenerering — Hunyuan3D-DiT (latent diffusjon / flow-matching på ShapeVAE-latenter) produserer et rent mesh.
2. Tekstursyntese — Hunyuan3D-Paint genererer flervisningsbilder betinget på geometri; utdata bakes inn i høyoppløselige teksturkart.
Utdataformater og integrasjon: Eksporterer vanlige 3D-formater (OBJ, GLB) og er utformet for å integreres med Unity, Unreal, Blender og standard produksjonspipelines. Enterprise API støtter generering av PBR-materialer og topologialternativer (triangler/quads).
Produksjonsfunksjoner: Smart topologi (mesh-optimalisering), low-poly-stilisering, texture baking og animasjonsstøtte i studio (skjelettbasert skinning via GNN for enkel retargeting i Hunyuan3D-Studio).

Ytelse i benchmark (publiserte måltall)

Fra den tekniske rapporten / evalueringen for Hunyuan3D 2.0 (representative måltall fra tabell 4 i artikkelen; høyere CLIP-score er bedre; lavere CMMD / FID-måltall er bedre):

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

Forfatterne rapporterer bedre geometridetaljer, høyere samsvar med betingelser og bedre kvalitet på teksturkart på tvers av automatiske måltall og en brukerundersøkelse med 300 tilfeller (50 deltakere), der Hunyuan3D 2.0 overgikk sammenlignbare metoder når det gjelder visuell kvalitet og samsvar med betingelsesbildet.

Representative produksjonsbrukstilfeller

Generering av spillressurser: rask prototyping av rekvisitter, miljøelementer, low- og high-poly karakter- eller rekvisittmesh + bakte teksturer; Hunyuan3D sin low-poly-stiliseringsmodul + texture baking integreres i spillpipelines.
3D e-handel / produktvisualisering: konverter produktbilder eller skisser til roterbare 3D-produktforhåndsvisninger for kataloger.
Kreative verktøy / studioer: skisse→3D-arbeidsflyter for kunstnere, automatisk UV-/teksturbaking og rask iterasjon for look development.
AR/VR-innhold og rask prototyping: generer miljøobjekter eller rekvisitter for oppslukende opplevelser, og optimaliser deretter via low-poly-stilisatoren og retargeting-/animasjonsmodulene.

Hvordan bruke Hunyuan3D 2.0

Trinn 1: Registrer deg for API-nøkkel

Logg inn på cometapi.com. Hvis du ikke er bruker hos oss ennå, vennligst registrer deg først. Logg inn i CometAPI-konsollen din. Hent API-nøkkelen for tilgang til grensesnittet. Klikk på “Add Token” under API-token i det personlige senteret, hent token-nøkkelen: sk-xxxxx og send inn.

Trinn 2: Send forespørsler til Hunyuan3D 2.0 API

Velg endepunktet “"Hunyuan3D-2"” for å sende API-forespørselen og angi request body. Forespørselsmetoden og request body hentes fra API-dokumentasjonen på nettstedet vårt. Nettstedet vårt tilbyr også Apifox-test for enkelhets skyld. Erstatt <YOUR_API_KEY> med den faktiske CometAPI-nøkkelen fra kontoen din. base url er Hunyuan3D

Sett inn forespørselen og bildet ditt i content-feltet—dette er det modellen vil svare på. Behandle API-responsen for å få det genererte svaret.

Hunyuan3D

Trinn 3: Hent og verifiser resultater

Behandle API-responsen for å få det genererte svaret. Etter behandling svarer API-et med oppgavestatus og utdata.

Priser for Hunyuan3D

Utforsk konkurransedyktige priser for Hunyuan3D, designet for å passe ulike budsjetter og bruksbehov. Våre fleksible planer sikrer at du bare betaler for det du bruker, noe som gjør det enkelt å skalere etter hvert som kravene dine vokser. Oppdag hvordan Hunyuan3D kan forbedre prosjektene dine samtidig som kostnadene holdes håndterbare.

Komet-pris (USD / M Tokens)	Offisiell pris (USD / M Tokens)	Rabatt
Per forespørsel:$0.08	Per forespørsel:$0.1	-20%

Eksempelkode og API for Hunyuan3D

Få tilgang til omfattende eksempelkode og API-ressurser for Hunyuan3D for å effektivisere integreringsprosessen din. Vår detaljerte dokumentasjon gir trinn-for-trinn-veiledning som hjelper deg med å utnytte det fulle potensialet til Hunyuan3D i prosjektene dine.

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