Le workflow HY 3D 2.1 est conçu pour transformer des images 2D uniques en modèles 3D détaillés à l’aide du modèle Hunyuan3D 2.1 de Tencent. Ce workflow exploite une série de nœuds spécialisés pour traiter une image et la convertir en un maillage 3D. Le processus commence avec les nœuds 'ImageOnlyCheckpointLoader' et 'LoadImage', qui préparent l’image pour la transformation 3D. Le nœud 'ModelSamplingAuraFlow' applique ensuite le modèle Hunyuan3D pour générer une représentation latente de l’image dans l’espace 3D. Ces données latentes sont ensuite traitées par les nœuds 'EmptyLatentHunyuan3Dv2' et 'Hunyuan3Dv2Conditioning' pour affiner la structure 3D.
Le workflow se poursuit avec le nœud 'KSampler', qui échantillonne les données latentes pour garantir que le modèle 3D soit aussi détaillé et précis que possible. Le nœud 'VAEDecodeHunyuan3D' décode ces données en une représentation voxel, qui est ensuite convertie en maillage via le nœud 'VoxelToMesh'. Enfin, le nœud 'SaveGLB' exporte le modèle 3D au format GLB, prêt à être utilisé dans diverses applications. Ce workflow est particulièrement utile pour les artistes et développeurs souhaitant créer du contenu 3D à partir d’assets 2D existants, offrant un processus simplifié qui minimise les efforts de modélisation manuelle.
API
Utiliser ce workflow depuis le code
Chaque workflow Comfy est un graphe JSON. Le contenu ci-dessous est ce workflow, exactement comme ComfyUI l’exécute — récupérez-le depuis l’URL, gardez-le dans le contrôle de version, ou chargez-le dans ComfyUI et exécutez-le nœud par nœud.
Exécutez-le depuis TypeScript ou Python avec le Comfy SDK. Le même code cible Comfy Cloud ou un ComfyUI auto-hébergé — seule l’URL de base change.
// Install (beta)
npm i @comfyorg/sdk
// Run "Hunyuan3D 2.1" (TypeScript)
import { Comfy } from "@comfyorg/sdk";
const client = new Comfy({ apiKey: "comfyui-..." });
// This workflow, exported in API format (see note below)
const wf = await client.workflows.fromFile("3d_hunyuan3d-v2.1_api.json");
const asset = client.assets.fromFile("input.png");
wf.setInput("2", "image", asset); // LoadImage
const job = await client.run(wf);
await job.getOutputs("10")[0].toFile("output.png"); // SaveGLBLe SDK prend un workflow au format API : ouvrez ce workflow dans ComfyUI et utilisez Fichier → Exporter le workflow (API).
L’accès à l’API Comfy Cloud nécessite un forfait avec clé API.
FAQ
