Hunyuan3d 2 0

Une phrase pour présenter

Hunyuan3D 2.0 est un modèle de génération d’actifs 3D publié par l’équipe Hunyuan de Tencent, capable de générer d’abord des réseaux géométriques à partir d’images ou de textes, puis de synthétiser des textures haute résolution pour ces réseaux.

Présentation des outils

Hunyuan3D 2.0 se compose du modèle géométrique Hunyuan3D-DiT et du modèle de texture Hunyuan3D-Paint. Grâce à la dissociation entre la géométrie et les textures, l’utilisateur peut créer des modèles complets avec textures, ou bien ne générer que des maquettes blanches, ou encore redessiner des textures pour des meshes existants.

Cette version a été publiée en janvier 2025, et le code ainsi que les poids des modèles peuvent être utilisés pour une mise en œuvre locale. Tencent a par la suite publié les versions 2.1, 2.5 ainsi que les versions cloud 3.0, 3.1, etc. Par conséquent, la version 2.0 doit être considérée comme une version historique encore utilisable, et non comme la version la plus récente.

Architecture de génération en deux étapes

La conception par étapes permet aux utilisateurs d’exécuter uniquement les parties nécessaires. Lorsqu’un maillage a déjà été modélisé manuellement, il est possible de sauter la génération géométrique et d’utiliser directement le pipeline des textures.

Fonction principale

Génération de géométrie 3D à partir d’une seule image

Lorsque l’utilisateur fournit des images de référence bien définies, le modèle géométrique déduit les vues invisibles et génère un maillage. Le résultat peut servir de modèle conceptuel, de prototype avant impression ou de point de départ pour un modélage manuel ultérieur.

Génération de multiples vues

La série Hunyuan3D-2mv peut recevoir plusieurs points de vue, améliorant ainsi les contraintes géométriques et la cohérence dans différentes directions. Les images d’entrée doivent représenter le même objet, avec des proportions similaires et un aspect cohérent ; sinon, des conflits structurels peuvent survenir.

Stable Diffusion 3D

Les services API locaux comprennent des chemins d’appel de texte vers 3D, et les services en ligne offrent également une capacité de génération 3D à partir de texte. La description textuelle convient mieux à l’exploration conceptuelle ; pour une reproduction précise d’un produit, il convient généralement d’utiliser des entrées en une seule image ou en plusieurs vues.

Génération de textures à haute résolution

Hunyuan3D-Paint utilise des maillages et des images de référence pour générer des textures, ce qui peut servir à colorer les modèles une fois qu’ils ont été créés, ou encore à traiter des maillages créés manuellement. La qualité de la texture dépend toujours des UV, de la topologie du maillage, de la netteté de l’image de référence et des ombres portées.

Version rapide et légère

Le projet propose des variantes Fast, Turbo, Mini et multivue, offrant différents compromis entre vitesse, mémoire vidéo, capacité géométrique et méthode d’entrée. Les versions légères ou distillées conviennent aux itérations rapides, mais les assets finaux doivent néanmoins être testés en fonction de la tâche.

Export du modèle

Le pipeline Python renvoie un objet de grille tridimensionnelle pouvant être traité davantage, et peut être enregistré dans des formats tels que GLB ou OBJ. Avant d’être intégré dans des processus de jeu, de cinéma, d’impression ou de e-commerce, il est généralement nécessaire de vérifier le nombre de faces, les normales, les UV, les matériaux et les unités.

Interface Gradio locale

L’entrepôt est accompagné d’une application Gradio, permettant aux utilisateurs de sélectionner des modèles via une interface graphique sur leur propre appareil, de télécharger des images de référence et de générer des actifs. Il convient pour les essais et les prototypes internes, mais les services en production nécessitent encore l’ajout de droits d’accès, de files d’attente, de surveillance et d’isolation des ressources.

Service API local

Les exemples officiels permettent de démarrer un service API local pour gérer la génération 3D à partir d’images, de texte, ainsi que la création de textures de maillages existants. Les développeurs peuvent intégrer les modèles dans leurs outils internes, mais doivent eux-mêmes mettre en œuvre l’authentification, le throttling, le suivi de l’état des tâches et le nettoyage des fichiers.

Extension Blender

Le projet fournit un plugin pour Blender qui permet d’appeler les capacités de génération depuis Blender une fois le service API local démarré. Le plugin raccourcit la chaîne entre la génération du modèle et son édition ultérieure, mais ne finalise pas automatiquement la topologie et la préparation à l’animation au niveau du jeu.

Comparaison des versions du modèle

Relation entre 2.0 et les versions ultérieures

Les noms des versions sont similaires, mais les licences, les interfaces, les prix et les méthodes de déploiement ne sont pas identiques. La licence communautaire du répertoire 2.0 ne peut pas représenter automatiquement les conditions des modèles ultérieurs ou des API commerciales de Tencent Cloud.

Exigences de déploiement local

Le projet prend en charge macOS, Windows et Linux, mais le module de textures comprend des composants de rasterisation personnalisés et de rendu différentiable ; la compatibilité réelle dépend de la carte graphique, des pilotes, de PyTorch et de l’environnement de compilation. Selon la liste officielle des modèles, la génération géométrique nécessite environ 6 Go de mémoire vidéo, tandis que le processus complet incluant géométrie et textures requiert environ 16 Go de mémoire vidéo.

Préparatifs avant l’installation

• Vérifier que les versions du système d’exploitation, des pilotes NVIDIA, de CUDA et de PyTorch sont compatibles entre elles.
• Allouez suffisamment d’espace disque pour les poids du modèle, le cache, les grilles intermédiaires et les fichiers de textures.
• La génération de textures nécessite la compilation de composants de rasterisation personnalisés et de rendu différentiable.
• Un environnement Windows ou avec une carte graphique non standard peut nécessiter une compilation supplémentaire et la résolution de problèmes de dépendances.
• Le déploiement en production doit utiliser un environnement indépendant pour verrouiller les versions des dépendances et conserver un historique de construction reproductible.

Guide d'utilisation locale

Installer et générer le premier modèle

1. Vérifier la mémoire vidéo et les pilotes de la carte graphique, et créer un environnement virtuel Python indépendant.
2. Installez PyTorch compatible avec le matériel, puis installez les dépendances du projet et le paquet Hunyuan3D.
3. Lorsqu’une texture est nécessaire, compilez un rasteriseur personnalisé et des composants de rendu différentiables.
4. Téléchargez les poids des modèles Hunyuan3D-DiT et Paint correspondants.
5. Préparez une image de référence avec le sujet centré, un arrière-plan simple et une résolution suffisante.
6. Téléchargez d’abord le pipeline géométrique pour générer le modèle blanc, puis vérifiez les contours et les angles de vue manquants.
7. Exécutez le pipeline de textures uniquement lorsque l’aspect final est nécessaire, puis exportez en GLB ou OBJ.
8. Vérifier les normales, la topologie, les UV, les matériaux et les proportions dans Blender ou d’autres outils DCC.

Déployer une API locale

1. Vérifiez d’abord avec un exemple minimal que le pipeline géométrique et textural peut fonctionner sur le dispositif actuel.
2. Démarrer le service API fourni avec le projet, et ne écouter que les interfaces réseau fiables.
3. Pour demander une authentification renforcée, des limites de taille de fichier et des délais d’exécution des tâches.
4. Concevez la génération à long terme comme une file d’attente asynchrone pour éviter que les connexions de demande ne soient constamment occupées.
5. Définir des dossiers isolés et des délais de suppression automatique pour les images téléchargées, les grilles et les actifs générés.
6. Enregistrer la version du modèle, la graine aléatoire et les paramètres pour faciliter la reproductibilité du problème.
7. Exécuter des tests de concurrence, de débordement de mémoire vidéo, de fichiers anormaux et d’épuisement du disque avant le lancement.

Suggestion pour l’entrée d’une image

• Privilégiez les images dont le sujet est complet, centré, aux bords nets et au fond propre.
• Éviter les obscurcissements importants, les réflexions miroir, les matériaux transparents et le flou de mouvement complexe.
• La réplique du produit doit fournir plusieurs vues cohérentes, telles que la face avant, le côté et l’arrière.
• Les couleurs, les proportions et les détails des différentes vues ne doivent pas être contradictoires entre eux.
• Les ombres fortes visibles sur la figure de référence pourraient être prises à tort pour des textures ; il conviendrait d’envisager un prétraitement d’éclairage.
• Une seule image ne permet pas de révéler les structures cachées ; le résultat généré doit être vérifié manuellement à l’arrière et en bas.

Post-traitement du modèle de sortie

• Supprimer la géométrie flottante, les surfaces auto-intersectantes, les trous et les structures internes invisibles.
• Vérifier que l’orientation de la face, la lisséité de la normale et l’axe du modèle correspondent au moteur cible.
• Redessiner la topologie et contrôler le nombre de polygones en fonction de l’utilisation pour la rendu en temps réel, l’impression ou le cinéma.
• Vérifier les joints UV, le déformation des textures, les canaux de matériaux et l’espace couleur.
• Avant l’impression 3D, vérifiez que le modèle est fermé, que l’épaisseur des parois, les proportions et la structure de soutien sont correctes.
• Avant de lier les os ou de créer une animation, il est nécessaire de mettre en place une topologie adaptée à la déformation.
• Vérifier avant utilisation commerciale les droits sur les images d’entrée, la marque, les personnes et les actifs générés.

Capacités actuelles de l’API Tencent Cloud

Actuellement, Tencent Cloud Hunyuan 3D ne considère plus la version 2.0 comme sa version la plus élevée. La version professionnelle permet d’utiliser les versions 3.0 et 3.1, et offre des fonctionnalités telles que la génération 3D à partir de texte, la génération 3D à partir d’images, plusieurs vues, des modèles blancs, des esquisses et la génération intelligente de topologie.

Tencent Cloud Documents indique également que l’ancienne plateforme du grand modèle Hunyuan est en train de migrer les nouvelles fonctionnalités vers TokenHub. Les services existants peuvent continuer à être utilisés, mais les nouvelles fonctionnalités achetées et les modèles ultérieurs doivent être vérifiés dans la console actuelle.

Prix de Tencent Cloud et forfaits de points

À partir du 23 août 2026, la plateforme chinoise utilise officiellement un système de facturation basé sur des points universels. Les nouveaux utilisateurs peuvent recevoir un pack d’essai de 100 points une seule fois, avec une période d’expiration gratuite d’un an ; le nombre de points déduits en réalité dépend des capacités de génération et de post-traitement choisies.

Règles de points et de remboursement

• Les points gratuits, les points prépayés et les points à la facturation postérieure sont déduits dans l’ordre de règlement correspondant.
• Les forfaits de points prépayés sont valables un an à partir de la date d’achat ; les parts non utilisées à l’expiration deviennent invalides.
• Une fois le pack de ressources utilisé, il n’est pas possible de geler les points restants.
• Les packs de ressources non utilisés après achat sont éligibles à un remboursement sans raison dans un délai de sept jours.
• Une fois le solde gratuit ou prépayé épuisé, on ne passe pas automatiquement en mode payant par défaut ; il faut l’activer manuellement.
• La consommation de points pour une tâche unique dépend de la version du modèle, du type de génération et des capacités de post-traitement.
• Le prix des forfaits de concurrence simultanée est élevé ; pour les opérations en grand volume, il convient d’abord de vérifier les solutions par défaut de concurrence et de file d’attente.

Comparaison des coûts d’API cloud et de déploiement local

Statut open source et licence

Hunyuan3D 2.0 met à disposition le code de raisonnement et les modèles pré-entraînés, mais il est soumis à la licence communautaire de Tencent Hunyuan3D 2.0, et non à MIT, Apache-2.0 ou à toute autre licence open source courante. Une indication plus précise dans le catalogue est « Code et poids mis en ligne, soumis à une licence communautaire personnalisée ».

Restrictions géographiques

La licence communautaire 2.0 exclut expressément l’Union européenne, le Royaume-Uni et la Corée du Sud de sa portée géographique. L’utilisation, la copie, la modification, la distribution ou la présentation des modèles et des résultats dans ces régions ne relève pas du champ d’application de cette licence.

Utilisation commerciale à grande échelle

Si le nombre total d’utilisateurs actifs mensuels pour l’ensemble des produits ou services du titulaire de la licence dépasse 1 million un mois avant la date de sortie de 2.0, il est nécessaire de demander une licence supplémentaire à Tencent. La facturation et l’approbation restent à la discrétion de Tencent.

Obligation de distribution

Lors de la distribution d’un modèle ou d’une œuvre dérivée, il est nécessaire de fournir une licence au destinataire, d’indiquer les modifications apportées au fichier, et d’accompagner la distribution via un service non hébergé d’un texte de notice. Lorsque des services sont fournis à des tiers, il convient également de révéler l’entité qui assure réellement la prestation du service, afin d’éviter tout malentendu quant à un parrainage ou une approbation de Tencent.

Limites de l’entraînement du modèle

La licence interdit d’utiliser les œuvres Hunyuan3D 2.0 ou leurs résultats pour améliorer d’autres modèles d’IA, à l’exception de Hunyuan3D 2.0 et de ses versions dérivées de modèles. Une étude particulière est nécessaire lorsqu’on envisage d’utiliser des actifs générés pour créer des ensembles de données d’entraînement pour d’autres modèles.

Droits de diffusion

La licence indique que Tencent ne revendique pas les droits sur les contenus générés par l’utilisateur, mais l’utilisateur est responsable des contenus générés ainsi que de leur utilisation ultérieure. Cette indication ne dispense pas de respecter les droits d’auteur sur les images d’entrée, les marques, les droits des personnes ou les risques liés à des matériaux provenant de tiers.

À qui s’adresse-t-il

• Développeurs qui étudient la génération 3D à partir de cartes, la diffusion géométrique et la génération de textures.
• Équipe technique souhaitant développer un prototype de génération d’actifs 3D sur une GPU locale.
• Il est nécessaire d’intégrer la génération 3D aux équipes de contenu utilisant Blender ou des flux de travail internes.
• Créateurs de props de jeux, de concepts cinématographiques, d’expositions en e-commerce et de prototypes imprimés en 3D.
• Pour les chercheurs souhaitant comparer les versions Mini, Fast, Turbo et multi-vues.
• Les entreprises qui ne souhaitent pas maintenir les services GPU et prévoient d’utiliser l’API 3D actuelle de Tencent Cloud.

Avantages du produit

• La géométrie et la texture sont générées séparément, ce qui facilite le remplacement ou l’utilisation indépendante à différentes étapes.
• Prend en charge la génération à partir d’une seule image, de plusieurs vues, de conditions de texte et de textures de grille existantes.
• Fournit un pipeline Python, une interface Gradio, une API locale et un plugin pour Blender.
• Il est possible d’exporter des formats 3D courants et de s’intégrer aux flux DCC et aux moteurs les plus répandus.
• La gamme de modèles couvre les besoins en norme, en légèreté, en vitesse et en multiples vues.
• Lors d’une installation locale, aucun frais n’est facturé au projet de modèle en fonction du nombre de générations.
• Les versions 2.1 ultérieures et Cloud 3.x offrent des voies d’upgrade pour différentes exigences en termes de qualité et de services.

Restrictions d'utilisation et précautions

• Une seule image ne peut pas restituer fidèlement les parties invisibles, et les structures complexes à l’arrière et à l’intérieur sont sujets aux erreurs.
• Générer un maillage n’est pas équivalent à un produit fini de jeu ou d’animation ; il est souvent nécessaire de le nettoyer, de le retopologiser et de redessiner les UV.
• La transparence, le réflexe, les fines lignes, les poils et des structures creuses complexes peuvent encore entraîner une instabilité.
• Le pipeline de textures complet nécessite environ 16 Go de mémoire vidéo et comprend des composants à compiler.
• Différentes combinaisons de systèmes et de cartes graphiques peuvent rencontrer des problèmes de compatibilité avec les pilotes, CUDA ou le rasteriseur.
• Les licences communautaires présentent des restrictions en termes de région, d’utilisateurs actifs par mois et d’entraînement du modèle.
• Le modèle actuel de Tencent Cloud et le modèle local 2.0 ne sont pas le même service ; les prix et les conditions ne peuvent pas être combinés.
• Tout résultat généré doit être vérifié manuellement avant d’être utilisé à des fins commerciales, d’impression ou dans des processus critiques pour la sécurité.

Informations de base

Questions fréquentes

Qu’est-ce que Hunyuan3D 2.0 ?

Il s’agit d’un système de génération d’actifs 3D à haute résolution développé par l’équipe Hunyuan de Tencent, qui crée d’abord un maillage à partir de modèles géométriques, puis applique des couleurs à l’aide de modèles de textures.

Est-ce que c’est gratuit ?

Le code local et les poids ne sont pas facturés en fonction du nombre d’appels, mais il faut respecter la licence communautaire et assumer soi-même les coûts de GPU, de stockage et de maintenance. L’API commerciale de Tencent Cloud propose quant à elle des crédits d’essai gratuits, des forfaits prépayés ou un paiement à la facturation.

Combien de mémoire vidéo est nécessaire ?

Les valeurs de référence indiquées dans le tableau officiel du modèle sont d’environ 6 GB pour la génération géométrique, et d’environ 16 GB pour l’ensemble du processus incluant les textures. L’espace réel occupé varie en fonction de la version du modèle, de la résolution, de la précision et du nombre de tâches simultanées.

Est-ce que cela prend en charge Windows ?

Le projet indique la compatibilité avec Windows, macOS et Linux. Le composant des textures doit être compilé localement, et l’environnement Windows peut encore présenter des problèmes supplémentaires en raison de la combinaison d’outils de compilation, de pilotes et de CUDA.

Peut-on l’importer dans Blender ?

Il est possible d’exporter des fichiers GLB, OBJ, etc., et un plugin Blender est également fourni pour une utilisation avec l’API locale. Après importation, il convient de vérifier les coordonnées, les proportions, les matériaux, les normales et la topologie.

Est-il possible de générer des modèles qui peuvent être utilisés directement dans les jeux ?

Il n’est généralement pas possible de garantir une conformité directe aux normes de production. Les résultats obtenus nécessitent souvent de réduire le nombre de faces, de re-topologiser, de corriger les normales, de re-UVer, d’organiser les matériaux et de vérifier les performances du moteur.

Hunyuan3D 2.0 est-il entièrement open source ?

Le code et les poids sont publics, mais une licence communautaire personnalisée est utilisée, avec des restrictions liées à la région, à l’échelle, à la distribution et à l’entraînement. Par conséquent, il ne faut pas simplement le qualifier de logiciel open source de type MIT ou Apache.

Tencent Cloud est-il encore à la version 2.0 ?

La version professionnelle actuelle propose les versions 3.0 et 3.1, ainsi qu’une version ultra-rapide et des interfaces de post-traitement pour la topologie, les textures, les composants et les UV. La version 2.0 existe principalement en tant que modèle historique pouvant être déployé localement.

Les points Tencent Cloud expirent-ils ?

Oui. Le forfait de points prépayés actuel est valable un an à partir de la date d’achat, et la partie non utilisée expire ; les forfaits déjà utilisés ne permettent pas de geler les points restants.

Peut-on utiliser les résultats générés pour entraîner d’autres modèles ?

La licence communautaire 2.0 interdit d’utiliser des œuvres de modèles ou des résultats pour améliorer d’autres modèles d’IA, à l’exception de Hunyuan3D 2.0 et de ses versions dérivées de modèles. Avant l’entraînement, un service juridique doit vérifier l’usage prévu.

Résumé

Hunyuan3D 2.0 est destiné aux développeurs qui souhaitent effectuer des recherches locales ou intégrer la génération 3D à partir d’images, la génération géométrique et la synthèse de textures. Son architecture en deux étapes, ses multiples variantes de modèles, son API locale et son plugin pour Blender offrent un point de départ technique assez complet.

Avant de l’adopter, il convient d’évaluer en même temps le matériel, le volume de travail de post-traitement et les restrictions liées aux licences communautaires. Si l’on privilégie les modèles les plus récents, sans avoir besoin de créer sa propre GPU ni du support des API d’entreprise, il faut comparer les versions actuelles de Tencent Cloud 3.0, 3.1 et l’édition accélérée, et calculer les coûts en fonction des règles de points en temps réel.