# Nœuds ComfyUI

ComfyUI-Tripo est l’extension officielle de nœuds personnalisés de Tripo pour ComfyUI. Elle intègre aux workflows ComfyUI la génération 3D à partir de texte, d’images ou de vues multiples, ainsi que l’import de modèles, le texturage, l’affinage, le traitement de maillages, l’optimisation low-poly, la stylisation, le rigging, le retargeting d’animation, la conversion de formats et la retopologie.

| Élément | Valeur |
| --- | --- |
| Version du projet Node | <code>1.3.0</code> |
| Tag source | <code>v1.3.1.1</code> |
| Dépôt | [VAST-AI-Research/ComfyUI-Tripo](https://github.com/VAST-AI-Research/ComfyUI-Tripo) |

## Fonctions et journal des modifications

### Fonctions

- Générer des modèles 3D à partir de texte.
- Générer des modèles 3D à partir d’images.
- Importer des modèles depuis une URL avec <code>model_url</code>.
- Prend en charge la séparation des parties du modèle.
- Rigger et animer des modèles 3D.
- Convertir les formats et retopologiser les modèles.

### Journal des modifications

- 2026-06-30 : ajout de Mesh Segmentation v2.0 pour découper les modèles en pièces et de l’import direct par URL avec <code>model_url</code>.
- 2026-05-28 : ajout de l’import de modèles.
- 2025-06-19 : mise à jour vers la dernière API et ajout de nœuds.
- 2025-03-31 : adoption du package <code>tripo3d</code>.
- 2025-02-24 : suppression de <code>glbviewer</code>.
- 2025-02-01 : adaptation à la nouvelle API et adoption de Preview 3D pour l’affichage.
- 2024-11-11 : adaptation à la nouvelle API.
- 2024-10-14 : ajout de la conversion de modèles.
- 2024-09-13 : prise en charge de <code>model_version</code> <code>v2.0-20240919</code>.

## Installation

Outils officiels : [ComfyUI-Manager](https://github.com/ltdrdata/ComfyUI-Manager), [Comfy Registry](https://registry.comfy.org/) et [comfy-cli](https://github.com/Comfy-Org/comfy-cli).

**Choisissez une méthode** puis redémarrez ComfyUI.

1. **ComfyUI-Manager:** Recherchez <code>Tripo for ComfyUI</code> dans Custom Nodes Manager et installez-le.
2. **comfy-cli:**

~~~bash
comfy node registry-install comfyui-tripo
~~~

3. **Depuis les sources:**

~~~bash
cd ComfyUI/custom_nodes
git clone https://github.com/VAST-AI-Research/ComfyUI-Tripo.git
python -m pip install -r ComfyUI-Tripo/requirements.txt
~~~

## Configuration de l’API Key

Créez d’abord une API Key sur la [plateforme Tripo](https://platform.tripo3d.ai/), puis configurez-la avec l’une des méthodes ci-dessous.

La clé est résolue dans cet ordre :

1. Entrée <code>apikey</code> non vide du nœud.
2. Variable d’environnement <code>TRIPO_API_KEY</code>.
3. Champ <code>TRIPO_API_KEY</code> de <code>config.json</code> dans le répertoire du projet.

Generate et Import exposent <code>apikey</code> ; les nœuds suivants reçoivent la clé résolue via <code>MODEL_INFO</code>. N’exposez jamais une vraie clé dans des captures, workflows, journaux ou dépôts.

### Exemples de lancement avec variable d’environnement

Windows :

~~~shell
set TRIPO_API_KEY=tsk_XXXXXXX
python.exe main.py [--cpu]
~~~

Linux ou macOS :

~~~bash
TRIPO_API_KEY=tsk_XXXXXXX python main.py [--cpu]
~~~

## Vue d’ensemble des nœuds

ComfyUI-Tripo fournit les 11 nœuds Tripo suivants :

| Internal ID | Display name | Capacité | Sortie |
| --- | --- | --- | --- |
| <code>TripoAPIDraft</code> | Tripo: Generate model | Génère un modèle depuis du texte, une image ou plusieurs vues. | STRING <code>model_file</code> + <code>MODEL_INFO</code> |
| <code>TripoImportModel</code> | Tripo: Import model | Importe un modèle local ou une URL. | <code>MODEL_INFO</code> |
| <code>TripoTextureModel</code> | Tripo: Texture model | Texture un modèle. | STRING <code>model_file</code> + <code>MODEL_INFO</code> |
| <code>TripoRefineModel</code> | Tripo: Refine Draft model | Affine un brouillon compatible. | STRING <code>model_file</code> + <code>MODEL_INFO</code> |
| <code>TripoMeshSegmentation</code> | Tripo: Segment mesh | Segmente un maillage. | STRING <code>model_file</code> + <code>MODEL_INFO</code> |
| <code>TripoMeshCompletion</code> | Tripo: Complete mesh | Complète un maillage segmenté. | STRING <code>model_file</code> + <code>MODEL_INFO</code> |
| <code>TripoSmartLowPoly</code> | Tripo: Smart low poly | Crée un modèle low-poly. | STRING <code>model_file</code> + <code>MODEL_INFO</code> |
| <code>TripoStylizeModel</code> | Tripo: Stylize model | Applique un style géométrique. | STRING <code>model_file</code> + <code>MODEL_INFO</code> |
| <code>TripoAnimateRigNode</code> | Tripo: Rig model | Réalise le rigging automatique. | STRING <code>model_file</code> + <code>MODEL_INFO</code> |
| <code>TripoAnimateRetargetNode</code> | Tripo: Retarget rigged model | Applique une animation prédéfinie. | STRING <code>model_file</code> + <code>MODEL_INFO</code> |
| <code>TripoConvertNode</code> | Tripo: Convert model | Convertit et exporte un modèle. | STRING <code>model_file</code> |

Preview 3D est fourni par ComfyUI et ne compte pas parmi les 11 nœuds Tripo.

## Connexions et flux de données

~~~mermaid
flowchart LR
    G["Generate model"] -->|MODEL_INFO| P["Traitement du modèle"]
    I["Import model"] -->|MODEL_INFO| P
    P -->|MODEL_INFO| R["Rig model"]
    R -->|MODEL_INFO| A["Retarget rigged model"]
    A -->|MODEL_INFO| C["Convert model"]
~~~

- <code>model_file</code> est le chemin du fichier téléchargé destiné à la prévisualisation ou au traitement.
- <code>MODEL_INFO</code> contient <code>task_id</code>, l’<code>apikey</code> résolue, <code>file_prefix</code> et <code>output_directory</code>.
- Un modèle externe doit d’abord passer par <code>TripoImportModel</code> ; un chemin de fichier ne remplace pas <code>MODEL_INFO</code>.
- Connectez <code>MODEL_INFO</code> pour poursuivre le traitement Tripo.

## Référence complète des nœuds

« Obligatoire » indique les entrées requises par la définition du nœud. Un <code>apikey</code> vide peut utiliser l’environnement ou la configuration. Un tiret indique qu’aucune valeur par défaut explicite n’est définie.

### Génération et import

### TripoAPIDraft — Tripo: Generate model

Génère un modèle depuis du texte, une image ou plusieurs vues.

| Entrée | Type | Obligatoire | Défaut | Valeurs / plage |
| --- | --- | --- | --- | --- |
| <code>mode</code> | ENUM | Oui | première valeur | <code>text_to_model</code>, <code>image_to_model</code>, <code>multiview_to_model</code> |
| <code>apikey</code> | STRING | Oui | vide | API key ou configuration de secours |
| <code>prompt</code> | STRING multiline | Non | vide | <code>text_to_model</code> |
| <code>negative_prompt</code> | STRING multiline | Non | vide | — |
| <code>image</code> | IMAGE | Non | — | <code>image_to_model</code> source; <code>multiview_to_model</code> vue avant |
| <code>image_left</code> | IMAGE | Non | — | <code>multiview_to_model</code> |
| <code>image_back</code> | IMAGE | Non | — | <code>multiview_to_model</code> |
| <code>image_right</code> | IMAGE | Non | — | <code>multiview_to_model</code> |
| <code>model_version</code> | ENUM | Non | <code>v3.1-20260211</code> | <code>v1.4-20240625</code>, <code>v2.0-20240919</code>, <code>v2.5-20250123</code>, <code>v3.0-20250812</code>, <code>v3.1-20260211</code> |
| <code>texture</code> | BOOLEAN | Non | <code>true</code> | — |
| <code>pbr</code> | BOOLEAN | Non | <code>true</code> | — |
| <code>image_seed</code> | INT | Non | <code>42</code> | <code>text_to_model</code> |
| <code>model_seed</code> | INT | Non | <code>42</code> | — |
| <code>texture_seed</code> | INT | Non | <code>42</code> | — |
| <code>texture_quality</code> | ENUM | Non | <code>standard</code> | <code>standard</code>, <code>detailed</code> |
| <code>geometry_quality</code> | ENUM | Non | <code>standard</code> | <code>standard</code>, <code>detailed</code>; <code>image_to_model</code> |
| <code>texture_alignment</code> | ENUM | Non | <code>original_image</code> | <code>original_image</code>, <code>geometry</code> |
| <code>face_limit</code> | INT | Non | <code>-1</code> | <code>-1</code>–<code>500000</code>; ≤ 0 est considéré comme non défini |
| <code>quad</code> | BOOLEAN | Non | <code>false</code> | — |
| <code>compress</code> | BOOLEAN | Non | <code>false</code> | — |
| <code>generate_parts</code> | BOOLEAN | Non | <code>false</code> | — |
| <code>smart_low_poly</code> | BOOLEAN | Non | <code>false</code> | — |
| <code>auto_size</code> | BOOLEAN | Non | <code>false</code> | — |
| <code>orientation</code> | ENUM | Non | <code>default</code> | <code>default</code>, <code>align_image</code>; modes image/multiview |
| <code>file_prefix</code> | STRING | Non | vide | — |
| <code>output_directory</code> | STRING | Non | vide | — |

**Sortie:** STRING <code>model_file</code> + <code>MODEL_INFO</code>. **Prérequis:** aucun. **Échecs fréquents:** entrée conditionnelle/clé manquante, tâche API ou déplacement de sortie en échec. **Connexion minimale:** Texte/image → <code>TripoAPIDraft</code> → Preview 3D.

Les trois modes imposent les entrées conditionnelles suivantes :

| <code>mode</code> | Obligatoire selon le mode | Remarque |
| --- | --- | --- |
| <code>text_to_model</code> | <code>prompt</code> | <code>prompt</code> ne doit pas être vide. |
| <code>image_to_model</code> | <code>image</code> | <code>image</code> est requis. |
| <code>multiview_to_model</code> | <code>image</code> | <code>image</code> est la vue avant ; gauche, arrière et droite sont facultatives. |

### TripoImportModel — Tripo: Import model

Importe un modèle local ou une URL.

| Entrée | Type | Obligatoire | Défaut | Valeurs / plage |
| --- | --- | --- | --- | --- |
| <code>apikey</code> | STRING | Oui | vide | API key ou configuration de secours |
| <code>model_file</code> | file selector | Non | <code>none</code> | répertoire input de ComfyUI |
| <code>model_url</code> | STRING | Non | vide | URL directe |
| <code>file_prefix</code> | STRING | Non | vide | propagé aux nœuds suivants |
| <code>output_directory</code> | STRING | Non | vide | propagé aux nœuds suivants |

**Sortie:** <code>MODEL_INFO</code>. **Prérequis:** fichier local ou URL. **Échecs fréquents:** source absente/inaccessible, format refusé ou import en échec. **Connexion minimale:** fichier local ou URL → <code>TripoImportModel</code> → MODEL_INFO.

Un <code>model_url</code> non vide est prioritaire sur <code>model_file</code>. Sans les deux, le nœud échoue. Le contrôle accepte <code>.glb</code>, <code>.fbx</code>, <code>.obj</code>, <code>.stl</code>, <code>.ply</code>, <code>.3mf</code> et <code>.gltf</code> ; le backend détecte aussi <code>.zip</code>.

### Traitement du modèle

### TripoTextureModel — Tripo: Texture model

Texture un modèle.

| Entrée | Type | Obligatoire | Défaut | Valeurs / plage |
| --- | --- | --- | --- | --- |
| <code>model_info</code> | MODEL_INFO | Oui | — | contexte de tâche amont |
| <code>model_version</code> | ENUM | Non | <code>v3.0-20250812</code> | <code>v2.5-20250123</code>, <code>v3.0-20250812</code> |
| <code>texture</code> | BOOLEAN | Non | <code>true</code> | — |
| <code>pbr</code> | BOOLEAN | Non | <code>true</code> | — |
| <code>texture_seed</code> | INT | Non | <code>42</code> | — |
| <code>texture_quality</code> | ENUM | Non | <code>standard</code> | <code>standard</code>, <code>detailed</code> |
| <code>texture_alignment</code> | ENUM | Non | <code>original_image</code> | <code>original_image</code>, <code>geometry</code> |
| <code>text_prompt</code> | STRING multiline | Non | vide | — |
| <code>image_prompt</code> | IMAGE | Non | — | — |
| <code>style_image</code> | IMAGE | Non | — | — |
| <code>part_names</code> | STRING multiline | Non | vide | one name per line |
| <code>compress</code> | BOOLEAN | Non | <code>false</code> | — |
| <code>bake</code> | BOOLEAN | Non | <code>true</code> | — |

**Sortie:** STRING <code>model_file</code> + <code>MODEL_INFO</code>. **Prérequis:** Generate / Import MODEL_INFO. **Échecs fréquents:** contexte incompatible, image invalide ou échec API. **Connexion minimale:** Generate / Import → <code>TripoTextureModel</code> → Preview 3D.

### TripoRefineModel — Tripo: Refine Draft model

Affine un brouillon compatible.

| Entrée | Type | Obligatoire | Défaut | Valeurs / plage |
| --- | --- | --- | --- | --- |
| <code>model_info</code> | MODEL_INFO | Oui | — | contexte de brouillon |

**Sortie:** STRING <code>model_file</code> + <code>MODEL_INFO</code>. **Prérequis:** MODEL_INFO d’un brouillon compatible. **Échecs fréquents:** brouillon non compatible ou échec API. **Connexion minimale:** Generate draft → <code>TripoRefineModel</code> → Preview 3D.

### TripoMeshSegmentation — Tripo: Segment mesh

Segmente un maillage.

| Entrée | Type | Obligatoire | Défaut | Valeurs / plage |
| --- | --- | --- | --- | --- |
| <code>model_info</code> | MODEL_INFO | Oui | — | contexte de tâche amont |
| <code>model_version</code> | ENUM | Oui | <code>v1.0-20250506</code> | <code>v1.0-20250506</code>, <code>v2.0-20260430</code> |
| <code>segmentation_granularity</code> | ENUM | Non | <code>balanced</code> | <code>simple</code>, <code>balanced</code>, <code>detailed</code>; v2 uniquement |
| <code>ref_image</code> | IMAGE | Non | — | v2 uniquement |
| <code>split_by_connectivity</code> | BOOLEAN | Non | <code>true</code> | v2 uniquement |

**Sortie:** STRING <code>model_file</code> + <code>MODEL_INFO</code>. **Prérequis:** Generate / Import MODEL_INFO. **Échecs fréquents:** modèle/référence incompatible ou échec API. **Connexion minimale:** Generate / Import → <code>TripoMeshSegmentation</code> → Completion / Preview.

<code>segmentation_granularity</code>, <code>ref_image</code> et <code>split_by_connectivity</code> ne sont envoyés qu’avec <code>v2.0-20260430</code> ; v1 les ignore.

### TripoMeshCompletion — Tripo: Complete mesh

Complète un maillage segmenté.

| Entrée | Type | Obligatoire | Défaut | Valeurs / plage |
| --- | --- | --- | --- | --- |
| <code>model_info</code> | MODEL_INFO | Oui | — | contexte segmenté |
| <code>model_version</code> | ENUM | Oui | <code>v1.0-20250506</code> | <code>v1.0-20250506</code> |
| <code>part_names</code> | STRING multiline | Non | vide | one name per line |

**Sortie:** STRING <code>model_file</code> + <code>MODEL_INFO</code>. **Prérequis:** MODEL_INFO segmenté. **Échecs fréquents:** tâche impropre à la complétion ou échec API. **Connexion minimale:** Segment → <code>TripoMeshCompletion</code> → Preview 3D.

### TripoSmartLowPoly — Tripo: Smart low poly

Crée un modèle low-poly.

| Entrée | Type | Obligatoire | Défaut | Valeurs / plage |
| --- | --- | --- | --- | --- |
| <code>model_info</code> | MODEL_INFO | Oui | — | contexte de tâche amont |
| <code>model_version</code> | ENUM | Oui | <code>P-v2.0-20251225</code> | <code>P-v2.0-20251225</code> |
| <code>quad</code> | BOOLEAN | Non | <code>false</code> | — |
| <code>part_names</code> | STRING multiline | Non | vide | one name per line |
| <code>face_limit</code> | INT | Non | <code>10000</code> | <code>-1</code>–<code>20000</code> |
| <code>bake</code> | BOOLEAN | Non | <code>true</code> | — |

**Sortie:** STRING <code>model_file</code> + <code>MODEL_INFO</code>. **Prérequis:** Generate / Import MODEL_INFO. **Échecs fréquents:** modèle/parties incompatibles ou échec API. **Connexion minimale:** Generate / Import → <code>TripoSmartLowPoly</code> → Preview / Convert.

### TripoStylizeModel — Tripo: Stylize model

Applique un style géométrique.

| Entrée | Type | Obligatoire | Défaut | Valeurs / plage |
| --- | --- | --- | --- | --- |
| <code>model_info</code> | MODEL_INFO | Oui | — | contexte de tâche amont |
| <code>style</code> | ENUM | Oui | première valeur | <code>lego</code>, <code>voxel</code>, <code>voronoi</code>, <code>minecraft</code> |
| <code>block_size</code> | INT | Oui | <code>80</code> | <code>1</code>–<code>1000</code> |

**Sortie:** STRING <code>model_file</code> + <code>MODEL_INFO</code>. **Prérequis:** Generate / Import MODEL_INFO. **Échecs fréquents:** modèle/style incompatible ou échec API. **Connexion minimale:** Generate / Import → <code>TripoStylizeModel</code> → Preview 3D.

### Rigging et animation

### TripoAnimateRigNode — Tripo: Rig model

Réalise le rigging automatique.

| Entrée | Type | Obligatoire | Défaut | Valeurs / plage |
| --- | --- | --- | --- | --- |
| <code>model_info</code> | MODEL_INFO | Oui | — | contexte de tâche amont |
| <code>model_version</code> | ENUM | Oui | <code>v2.0-20250506</code> | <code>v1.0-20240301</code>, <code>v2.0-20250506</code> |
| <code>out_format</code> | ENUM | Oui | <code>glb</code> | <code>glb</code>, <code>fbx</code> |
| <code>spec</code> | ENUM | Oui | <code>tripo</code> | <code>mixamo</code>, <code>tripo</code> |

**Sortie:** STRING <code>model_file</code> + <code>MODEL_INFO</code>. **Prérequis:** Generate / Import MODEL_INFO. **Échecs fréquents:** modèle non riggable, aucun rig type ou échec API. **Connexion minimale:** Generate / Import → <code>TripoAnimateRigNode</code> → Retarget / Preview.

Avant le rigging, le nœud vérifie la compatibilité et obtient un rig type.

### TripoAnimateRetargetNode — Tripo: Retarget rigged model

Applique une animation prédéfinie.

| Entrée | Type | Obligatoire | Défaut | Valeurs / plage |
| --- | --- | --- | --- | --- |
| <code>model_info</code> | MODEL_INFO | Oui | — | contexte riggé |
| <code>animation</code> | ENUM | Oui | première valeur | 16 presets ci-dessous |
| <code>out_format</code> | ENUM | Oui | <code>glb</code> | <code>glb</code>, <code>fbx</code> |
| <code>bake_animation</code> | BOOLEAN | Non | <code>true</code> | — |
| <code>export_with_geometry</code> | BOOLEAN | Non | <code>false</code> | — |

**Sortie:** STRING <code>model_file</code> + <code>MODEL_INFO</code>. **Prérequis:** MODEL_INFO riggé. **Échecs fréquents:** contexte non riggé ou échec API. **Connexion minimale:** Rig → <code>TripoAnimateRetargetNode</code> → Preview / Convert.

Les 16 valeurs d’animation sont: <code>preset:idle</code>, <code>preset:walk</code>, <code>preset:run</code>, <code>preset:dive</code>, <code>preset:climb</code>, <code>preset:jump</code>, <code>preset:slash</code>, <code>preset:shoot</code>, <code>preset:hurt</code>, <code>preset:fall</code>, <code>preset:turn</code>, <code>preset:quadruped:walk</code>, <code>preset:hexapod:walk</code>, <code>preset:octopod:walk</code>, <code>preset:serpentine:march</code>, <code>preset:aquatic:march</code>.

### Sortie de format

### TripoConvertNode — Tripo: Convert model

Convertit et exporte un modèle.

| Entrée | Type | Obligatoire | Défaut | Valeurs / plage |
| --- | --- | --- | --- | --- |
| <code>model_info</code> | MODEL_INFO | Oui | — | contexte de tâche amont |
| <code>format</code> | ENUM | Oui | première valeur | <code>GLTF</code>, <code>USDZ</code>, <code>FBX</code>, <code>OBJ</code>, <code>STL</code>, <code>3MF</code> |
| <code>quad</code> | BOOLEAN | Non | <code>false</code> | — |
| <code>force_symmetry</code> | BOOLEAN | Non | <code>false</code> | — |
| <code>face_limit</code> | INT | Non | <code>-1</code> | <code>-1</code>–<code>500000</code> |
| <code>flatten_bottom</code> | BOOLEAN | Non | <code>false</code> | — |
| <code>flatten_bottom_threshold</code> | FLOAT | Non | <code>0.01</code> | <code>0.0</code>–<code>1.0</code> |
| <code>texture_size</code> | INT | Non | <code>4096</code> | <code>128</code>–<code>4096</code> |
| <code>texture_format</code> | ENUM | Non | <code>JPEG</code> | <code>BMP</code>, <code>DPX</code>, <code>HDR</code>, <code>JPEG</code>, <code>OPEN_EXR</code>, <code>PNG</code>, <code>TARGA</code>, <code>TIFF</code>, <code>WEBP</code> |
| <code>pivot_to_center_bottom</code> | BOOLEAN | Non | <code>false</code> | — |
| <code>scale_factor</code> | FLOAT | Non | <code>1.0</code> | minimum <code>0</code> |
| <code>with_animation</code> | BOOLEAN | Non | <code>true</code> | — |
| <code>pack_uv</code> | BOOLEAN | Non | <code>false</code> | — |
| <code>bake</code> | BOOLEAN | Non | <code>true</code> | — |
| <code>part_names</code> | STRING multiline | Non | vide | one name per line |
| <code>fbx_preset</code> | ENUM | Non | <code>blender</code> | <code>blender</code>, <code>mixamo</code>, <code>3dsmax</code> |
| <code>export_vertex_colors</code> | BOOLEAN | Non | <code>false</code> | — |
| <code>export_orientation</code> | ENUM | Non | <code>+x</code> | <code>+x</code>, <code>+y</code>, <code>-x</code>, <code>-y</code> |
| <code>animate_in_place</code> | BOOLEAN | Non | <code>false</code> | — |

**Sortie:** STRING <code>model_file</code>. **Prérequis:** MODEL_INFO compatible. **Échecs fréquents:** conversion non prise en charge, réglages invalides ou erreur de sortie. **Connexion minimale:** MODEL_INFO → <code>TripoConvertNode</code>.

Convert est un nœud de sortie et ne renvoie pas <code>MODEL_INFO</code>.

## Exemples de workflows

Preview 3D est seulement un visualiseur ComfyUI facultatif.

~~~mermaid
flowchart LR
    T["Texte"] --> GT["Generate model<br/>mode: text_to_model"]
    IM["Image"] --> GI["Generate model<br/>mode: image_to_model"]
    MV["Vue avant + vues facultatives"] --> GM["Generate model<br/>mode: multiview_to_model"]
    GT --> V["Preview 3D"]
    GI --> V
    GM --> V
~~~

1. **Text to Model :** <code>prompt</code> → Generate avec <code>text_to_model</code> → Preview 3D.
2. **Image to Model :** IMAGE → <code>image</code>, mode <code>image_to_model</code> → Preview 3D.
3. **Multiview to Model :** avant vers <code>image</code>, vues facultatives vers <code>image_left</code>, <code>image_back</code> et <code>image_right</code>.
4. **Texture Model :** Generate/Import → MODEL_INFO → Texture → Preview.
5. **Refine Model :** brouillon compatible → MODEL_INFO → Refine → Preview.
6. **Rig and Retarget :** Generate/Import → Rig → Retarget en reliant MODEL_INFO.
7. **Import and Process :** fichier/URL → Import → Segment/Smart low poly/Stylize/Texture.
8. **Convert and Export :** MODEL_INFO final → Convert → choisir le format.

### PNG officiels des workflows

Les six PNG suivants contiennent les données de workflow ComfyUI. Enregistrez l’original via le lien de téléchargement, puis glissez-le dans ComfyUI ou chargez-le manuellement. Les valeurs de paramètres affichées dans les images sont uniquement des exemples ; les valeurs par défaut actuelles figurent dans les tableaux de paramètres.

#### Text to Mesh

![Workflow texte vers maillage avec Tripo Generate model et Preview 3D](/assets/images/docs/comfyui-nodes/text_to_model.png)

Génère un modèle depuis du texte et envoie <code>model_file</code> à Preview 3D.

<a href="/assets/images/docs/comfyui-nodes/text_to_model.png" download>Télécharger le PNG original du workflow</a>

#### Image to Mesh

![Workflow image vers maillage avec Load Image, Tripo Generate model et Preview 3D](/assets/images/docs/comfyui-nodes/image_to_model.png)

Charge une image, relie-la à Generate model en mode <code>image_to_model</code> et affiche le résultat.

<a href="/assets/images/docs/comfyui-nodes/image_to_model.png" download>Télécharger le PNG original du workflow</a>

#### Multiview Images to Mesh

![Workflow multivue avec trois nœuds Load Image, Tripo Generate model et Preview 3D](/assets/images/docs/comfyui-nodes/multiview_to_model.png)

Relie la vue de face et les vues latérales facultatives à Generate model en mode <code>multiview_to_model</code>.

<a href="/assets/images/docs/comfyui-nodes/multiview_to_model.png" download>Télécharger le PNG original du workflow</a>

#### Texture a generated model

![Workflow de texture avec Generate model, Texture model et Preview 3D](/assets/images/docs/comfyui-nodes/texture_model.png)

Transmet <code>MODEL_INFO</code> de Generate model à Texture model et affiche les deux sorties.

<a href="/assets/images/docs/comfyui-nodes/texture_model.png" download>Télécharger le PNG original du workflow</a>

#### Refine a draft Mesh

![Workflow d’affinage avec Generate model, Refine Draft model et Preview 3D](/assets/images/docs/comfyui-nodes/refine_model.png)

Génère un brouillon compatible, transmet <code>MODEL_INFO</code> à Refine Draft model et affiche le résultat.

<a href="/assets/images/docs/comfyui-nodes/refine_model.png" download>Télécharger le PNG original du workflow</a>

#### Animation / Rig and export

![Workflow de rig et export avec Generate model, Rig model, Preview 3D et Convert model](/assets/images/docs/comfyui-nodes/retarget.png)

<a href="/assets/images/docs/comfyui-nodes/retarget.png" download>Télécharger le PNG original du workflow</a>

## Sortie et dépannage

Les téléchargements vont par défaut dans <code>ComfyUI/output</code>. <code>file_prefix</code> renomme le fichier et <code>output_directory</code> le déplace ; les deux sont propagés dans <code>MODEL_INFO</code>.

| Symptôme | Vérification |
| --- | --- |
| API Key absente | Définir la clé du nœud, <code>TRIPO_API_KEY</code> ou <code>config.json</code>. |
| Prompt/vue avant absent | Vérifier le mode et son entrée conditionnelle. |
| Import ne démarre pas | Fournir une URL accessible ou un fichier existant ; l’URL est prioritaire. |
| Modèle non riggable | Utiliser un modèle de personnage adapté. |
| Tâche API en échec | Vérifier <code>error_code</code>, <code>error_msg</code>, accès et solde. |
| Sortie impossible à déplacer | Vérifier le chemin et les droits d’écriture. |
| Nœuds absents | Redémarrer ComfyUI et vérifier le répertoire et <code>requirements.txt</code>. |
| Échec du chargement | Vérifier l’extension et la réponse de chargement ComfyUI. |