Qu’est-ce que Hunyuan3D 2.0 ?

Définition courte : Hunyuan3D 2.0(*Hunyuan3D-2*) est un système génératif à grande échelle en deux étapes de Tencent, conçu pour produire des assets 3D texturés haute résolution à partir d’entrées multimodales (texte, 1 à 4 images, croquis). Le système sépare la génération de forme (Hunyuan3D-DiT / ShapeVAE) et la synthèse de texture (Hunyuan3D-Paint), avec en plus une interface/plateforme de production (Hunyuan3D-Studio).

Fonctionnalités principales

Entrées multimodales : Texte vers 3D, image vers 3D (1 à 4 vues), croquis vers 3D. Le site global et la documentation listent explicitement ces modes.
Pipeline en deux étapes :
1. Génération de forme — Hunyuan3D-DiT (diffusion latente / flow-matching sur les latents ShapeVAE) produit un maillage brut.
2. Synthèse de texture — Hunyuan3D-Paint génère des images multi-vues conditionnées par la géométrie ; les sorties sont ensuite cuites dans des cartes de texture haute résolution.
Formats de sortie et intégration : Exporte des formats 3D courants (OBJ, GLB) et est conçu pour s’intégrer à Unity, Unreal, Blender et aux pipelines de production standard. L’API entreprise prend en charge la génération de matériaux PBR et des options de topologie (triangles/quads).
Fonctionnalités de production : Topologie intelligente (optimisation du maillage), stylisation low-poly, texture baking et prise en charge de l’animation dans le studio (skinning squelettique via GNN pour un retargeting simple dans Hunyuan3D-Studio).

Performances de benchmark (métriques publiées)

D’après le rapport technique / l’évaluation de Hunyuan3D 2.0 (métriques représentatives du Tableau 4 de l’article ; un CLIP-score plus élevé est meilleur ; des métriques CMMD / FID plus faibles sont meilleures) :

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

Les auteurs rapportent un niveau supérieur de détail géométrique, de fidélité à la condition et de qualité des cartes de texture à travers les métriques automatiques ainsi qu’une étude utilisateur sur 300 cas (50 participants), dans laquelle Hunyuan3D 2.0 a surpassé les méthodes comparatives en qualité visuelle et en adhérence à l’image conditionnelle.

Cas d’usage de production représentatifs

Génération d’assets pour les jeux : prototypage rapide de props, éléments de décor, maillages de personnages ou d’objets low-poly et high-poly + textures baked ; le module de stylisation low-poly de Hunyuan3D + le texture baking s’intègrent aux pipelines de jeu.
E-commerce 3D / visualisation de produits : convertir des photos de produits ou des croquis en aperçus 3D rotatifs pour les catalogues.
Outils créatifs / studios : workflows croquis→3D pour les artistes, baking automatique des UV/textures et itérations rapides pour le look development.
Contenu AR/VR et prototypage rapide : générer des assets d’environnement ou des props pour des expériences immersives, puis les optimiser via le styliseur low-poly et les modules de retargeting/animation.

Comment utiliser Hunyuan3D 2.0

Étape 1 : S’inscrire pour obtenir une clé API

Connectez-vous à cometapi.com. Si vous n’êtes pas encore utilisateur, veuillez d’abord vous inscrire. Connectez-vous à votre console CometAPI. Obtenez la clé API d’accès à l’interface. Cliquez sur « Add Token » dans la section API token du centre personnel, obtenez la clé de token : sk-xxxxx et soumettez-la.

Étape 2 : Envoyer des requêtes à l’API Hunyuan3D 2.0

Sélectionnez le point de terminaison « "Hunyuan3D-2" » pour envoyer la requête API et définissez le corps de la requête. La méthode de requête et le corps de la requête sont disponibles dans la documentation API de notre site web. Notre site web fournit également un test Apifox pour votre commodité. Remplacez <YOUR_API_KEY> par votre clé CometAPI réelle depuis votre compte. L’URL de base est Hunyuan3D

Insérez votre requête et votre image dans le champ content — c’est ce à quoi le modèle répondra. Traitez la réponse API pour obtenir la réponse générée.

Hunyuan3D

Étape 3 : Récupérer et vérifier les résultats

Traitez la réponse API pour obtenir la réponse générée. Après traitement, l’API renvoie le statut de la tâche et les données de sortie.

Tarification pour Hunyuan3D

Découvrez des tarifs compétitifs pour Hunyuan3D, conçus pour s'adapter à différents budgets et besoins d'utilisation. Nos formules flexibles garantissent que vous ne payez que ce que vous utilisez, ce qui facilite l'adaptation à mesure que vos besoins évoluent. Découvrez comment Hunyuan3D peut améliorer vos projets tout en maîtrisant les coûts.

Prix de Comet (USD / M Tokens)	Prix officiel (USD / M Tokens)	Remise
Par requête:$0.08	Par requête:$0.1	-20%

Exemple de code et API pour Hunyuan3D

Accédez à des exemples de code complets et aux ressources API pour Hunyuan3D afin de simplifier votre processus d'intégration. Notre documentation détaillée fournit des instructions étape par étape pour vous aider à exploiter tout le potentiel de Hunyuan3D dans vos projets.

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