# Nodi ComfyUI

ComfyUI-Tripo è l’estensione ufficiale di nodi personalizzati Tripo per ComfyUI. Integra nei workflow di ComfyUI la generazione 3D da testo, immagini o viste multiple, insieme a importazione dei modelli, texturing, rifinitura, elaborazione delle mesh, ottimizzazione low-poly, stilizzazione, rigging, retargeting delle animazioni, conversione dei formati e retopologia.

| Voce | Valore |
| --- | --- |
| Versione del progetto Node | <code>1.3.0</code> |
| Tag sorgente | <code>v1.3.1.1</code> |
| Repository | [VAST-AI-Research/ComfyUI-Tripo](https://github.com/VAST-AI-Research/ComfyUI-Tripo) |

## Funzionalità e registro modifiche

### Funzionalità

- Generare modelli 3D da testo.
- Generare modelli 3D da immagini.
- Importare modelli da URL tramite <code>model_url</code>.
- Supporta la separazione delle parti del modello.
- Creare rig e animare modelli 3D.
- Convertire formati e retopologizzare modelli.

### Registro modifiche

- 2026-06-30: aggiunti Mesh Segmentation v2.0 per suddividere i modelli in parti e l’import diretto da URL tramite <code>model_url</code>.
- 2026-05-28: aggiunto import dei modelli.
- 2025-06-19: aggiornamento alla API più recente e aggiunta di altri nodi.
- 2025-03-31: adozione del pacchetto <code>tripo3d</code>.
- 2025-02-24: rimosso <code>glbviewer</code>.
- 2025-02-01: adattamento alla nuova API e adozione di Preview 3D per la visualizzazione.
- 2024-11-11: adattamento alla nuova API.
- 2024-10-14: aggiunta conversione dei modelli.
- 2024-09-13: supporto per <code>model_version</code> <code>v2.0-20240919</code>.

## Installazione

Strumenti ufficiali: [ComfyUI-Manager](https://github.com/ltdrdata/ComfyUI-Manager), [Comfy Registry](https://registry.comfy.org/) e [comfy-cli](https://github.com/Comfy-Org/comfy-cli).

**Scegli un metodo** e riavvia ComfyUI.

1. **ComfyUI-Manager:** Cerca <code>Tripo for ComfyUI</code> in Custom Nodes Manager e installalo.
2. **comfy-cli:**

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

3. **Dal sorgente:**

~~~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
~~~

## Configurazione API Key

Crea prima una API Key sulla [piattaforma Tripo](https://platform.tripo3d.ai/), poi configurala con uno dei metodi seguenti.

La chiave viene risolta in quest’ordine:

1. Input <code>apikey</code> non vuoto nel nodo.
2. Variabile d’ambiente <code>TRIPO_API_KEY</code>.
3. Campo <code>TRIPO_API_KEY</code> in <code>config.json</code> nella directory del progetto.

Generate e Import espongono <code>apikey</code>; i nodi successivi ricevono la chiave tramite <code>MODEL_INFO</code>. Non mostrare chiavi reali in screenshot, workflow, log o repository.

### Esempi di avvio con variabile d’ambiente

Windows:

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

Linux o macOS:

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

## Panoramica dei nodi

ComfyUI-Tripo fornisce i seguenti 11 nodi Tripo:

| ID interno | Nome visualizzato | Funzione | Output |
| --- | --- | --- | --- |
| <code>TripoAPIDraft</code> | Tripo: Generate model | Genera modelli da testo, immagine o più viste. | STRING <code>model_file</code> + <code>MODEL_INFO</code> |
| <code>TripoImportModel</code> | Tripo: Import model | Importa un modello locale o un URL. | <code>MODEL_INFO</code> |
| <code>TripoTextureModel</code> | Tripo: Texture model | Applica texture a un modello. | STRING <code>model_file</code> + <code>MODEL_INFO</code> |
| <code>TripoRefineModel</code> | Tripo: Refine Draft model | Rifinisce una bozza compatibile. | STRING <code>model_file</code> + <code>MODEL_INFO</code> |
| <code>TripoMeshSegmentation</code> | Tripo: Segment mesh | Segmenta una mesh. | STRING <code>model_file</code> + <code>MODEL_INFO</code> |
| <code>TripoMeshCompletion</code> | Tripo: Complete mesh | Completa una mesh segmentata. | STRING <code>model_file</code> + <code>MODEL_INFO</code> |
| <code>TripoSmartLowPoly</code> | Tripo: Smart low poly | Crea un modello low-poly. | STRING <code>model_file</code> + <code>MODEL_INFO</code> |
| <code>TripoStylizeModel</code> | Tripo: Stylize model | Applica uno stile geometrico. | STRING <code>model_file</code> + <code>MODEL_INFO</code> |
| <code>TripoAnimateRigNode</code> | Tripo: Rig model | Esegue il rig automatico. | STRING <code>model_file</code> + <code>MODEL_INFO</code> |
| <code>TripoAnimateRetargetNode</code> | Tripo: Retarget rigged model | Applica un’animazione predefinita. | STRING <code>model_file</code> + <code>MODEL_INFO</code> |
| <code>TripoConvertNode</code> | Tripo: Convert model | Converte ed esporta un modello. | STRING <code>model_file</code> |

Preview 3D è fornito da ComfyUI e non rientra negli 11 nodi Tripo.

## Connessioni e flusso dati

~~~mermaid
flowchart LR
    G["Generate model"] -->|MODEL_INFO| P["Elaborazione modello"]
    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> è il percorso del file scaricato per anteprima o gestione file.
- <code>MODEL_INFO</code> contiene <code>task_id</code>, <code>apikey</code> risolta, <code>file_prefix</code> e <code>output_directory</code>.
- Un modello esterno deve prima passare da <code>TripoImportModel</code>; un percorso file non sostituisce <code>MODEL_INFO</code>.
- Collega <code>MODEL_INFO</code> per continuare l’elaborazione Tripo.

## Riferimento completo dei nodi

“Obbligatorio” indica gli input richiesti dalla definizione del nodo. Un <code>apikey</code> vuoto può usare l’ambiente o la configurazione. Un trattino indica che non è definito alcun valore predefinito esplicito.

### Generazione e importazione

### TripoAPIDraft — Tripo: Generate model

Genera modelli da testo, immagine o più viste.

| Input | Tipo | Obbligatorio | Predefinito | Valori / intervallo |
| --- | --- | --- | --- | --- |
| <code>mode</code> | ENUM | Sì | primo valore | <code>text_to_model</code>, <code>image_to_model</code>, <code>multiview_to_model</code> |
| <code>apikey</code> | STRING | Sì | vuoto | API key o fallback |
| <code>prompt</code> | STRING multiline | No | vuoto | <code>text_to_model</code> |
| <code>negative_prompt</code> | STRING multiline | No | vuoto | — |
| <code>image</code> | IMAGE | No | — | <code>image_to_model</code> origine; <code>multiview_to_model</code> vista frontale |
| <code>image_left</code> | IMAGE | No | — | <code>multiview_to_model</code> |
| <code>image_back</code> | IMAGE | No | — | <code>multiview_to_model</code> |
| <code>image_right</code> | IMAGE | No | — | <code>multiview_to_model</code> |
| <code>model_version</code> | ENUM | No | <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 | No | <code>true</code> | — |
| <code>pbr</code> | BOOLEAN | No | <code>true</code> | — |
| <code>image_seed</code> | INT | No | <code>42</code> | <code>text_to_model</code> |
| <code>model_seed</code> | INT | No | <code>42</code> | — |
| <code>texture_seed</code> | INT | No | <code>42</code> | — |
| <code>texture_quality</code> | ENUM | No | <code>standard</code> | <code>standard</code>, <code>detailed</code> |
| <code>geometry_quality</code> | ENUM | No | <code>standard</code> | <code>standard</code>, <code>detailed</code>; <code>image_to_model</code> |
| <code>texture_alignment</code> | ENUM | No | <code>original_image</code> | <code>original_image</code>, <code>geometry</code> |
| <code>face_limit</code> | INT | No | <code>-1</code> | <code>-1</code>–<code>500000</code>; ≤ 0 equivale a non impostato |
| <code>quad</code> | BOOLEAN | No | <code>false</code> | — |
| <code>compress</code> | BOOLEAN | No | <code>false</code> | — |
| <code>generate_parts</code> | BOOLEAN | No | <code>false</code> | — |
| <code>smart_low_poly</code> | BOOLEAN | No | <code>false</code> | — |
| <code>auto_size</code> | BOOLEAN | No | <code>false</code> | — |
| <code>orientation</code> | ENUM | No | <code>default</code> | <code>default</code>, <code>align_image</code>; modalità immagine/multiview |
| <code>file_prefix</code> | STRING | No | vuoto | — |
| <code>output_directory</code> | STRING | No | vuoto | — |

**Output:** STRING <code>model_file</code> + <code>MODEL_INFO</code>. **Prerequisito:** nessuno. **Errori comuni:** input condizionale/chiave mancante, task API o spostamento output fallito. **Connessione minima:** Testo/immagine → <code>TripoAPIDraft</code> → Preview 3D.

I tre modi richiedono questi input condizionali:

| <code>mode</code> | Obbligatorio per modo | Nota |
| --- | --- | --- |
| <code>text_to_model</code> | <code>prompt</code> | <code>prompt</code> non può essere vuoto. |
| <code>image_to_model</code> | <code>image</code> | <code>image</code> è richiesto. |
| <code>multiview_to_model</code> | <code>image</code> | <code>image</code> è la vista frontale; sinistra, retro e destra sono opzionali. |

### TripoImportModel — Tripo: Import model

Importa un modello locale o un URL.

| Input | Tipo | Obbligatorio | Predefinito | Valori / intervallo |
| --- | --- | --- | --- | --- |
| <code>apikey</code> | STRING | Sì | vuoto | API key o fallback |
| <code>model_file</code> | file selector | No | <code>none</code> | directory input di ComfyUI |
| <code>model_url</code> | STRING | No | vuoto | URL diretto |
| <code>file_prefix</code> | STRING | No | vuoto | trasmesso ai nodi successivi |
| <code>output_directory</code> | STRING | No | vuoto | trasmesso ai nodi successivi |

**Output:** <code>MODEL_INFO</code>. **Prerequisito:** file locale o URL. **Errori comuni:** origine assente/non raggiungibile, formato rifiutato o import fallito. **Connessione minima:** file locale o URL → <code>TripoImportModel</code> → MODEL_INFO.

Un <code>model_url</code> non vuoto ha priorità su <code>model_file</code>. Senza entrambi il nodo fallisce. L’upload accetta <code>.glb</code>, <code>.fbx</code>, <code>.obj</code>, <code>.stl</code>, <code>.ply</code>, <code>.3mf</code> e <code>.gltf</code>; il backend rileva anche <code>.zip</code>.

### Elaborazione modello

### TripoTextureModel — Tripo: Texture model

Applica texture a un modello.

| Input | Tipo | Obbligatorio | Predefinito | Valori / intervallo |
| --- | --- | --- | --- | --- |
| <code>model_info</code> | MODEL_INFO | Sì | — | contesto task a monte |
| <code>model_version</code> | ENUM | No | <code>v3.0-20250812</code> | <code>v2.5-20250123</code>, <code>v3.0-20250812</code> |
| <code>texture</code> | BOOLEAN | No | <code>true</code> | — |
| <code>pbr</code> | BOOLEAN | No | <code>true</code> | — |
| <code>texture_seed</code> | INT | No | <code>42</code> | — |
| <code>texture_quality</code> | ENUM | No | <code>standard</code> | <code>standard</code>, <code>detailed</code> |
| <code>texture_alignment</code> | ENUM | No | <code>original_image</code> | <code>original_image</code>, <code>geometry</code> |
| <code>text_prompt</code> | STRING multiline | No | vuoto | — |
| <code>image_prompt</code> | IMAGE | No | — | — |
| <code>style_image</code> | IMAGE | No | — | — |
| <code>part_names</code> | STRING multiline | No | vuoto | un nome per riga |
| <code>compress</code> | BOOLEAN | No | <code>false</code> | — |
| <code>bake</code> | BOOLEAN | No | <code>true</code> | — |

**Output:** STRING <code>model_file</code> + <code>MODEL_INFO</code>. **Prerequisito:** Generate / Import MODEL_INFO. **Errori comuni:** contesto incompatibile, immagine non valida o errore API. **Connessione minima:** Generate / Import → <code>TripoTextureModel</code> → Preview 3D.

### TripoRefineModel — Tripo: Refine Draft model

Rifinisce una bozza compatibile.

| Input | Tipo | Obbligatorio | Predefinito | Valori / intervallo |
| --- | --- | --- | --- | --- |
| <code>model_info</code> | MODEL_INFO | Sì | — | contesto bozza |

**Output:** STRING <code>model_file</code> + <code>MODEL_INFO</code>. **Prerequisito:** MODEL_INFO di una bozza rifinibile. **Errori comuni:** bozza non rifinibile o errore API. **Connessione minima:** Generate draft → <code>TripoRefineModel</code> → Preview 3D.

### TripoMeshSegmentation — Tripo: Segment mesh

Segmenta una mesh.

| Input | Tipo | Obbligatorio | Predefinito | Valori / intervallo |
| --- | --- | --- | --- | --- |
| <code>model_info</code> | MODEL_INFO | Sì | — | contesto task a monte |
| <code>model_version</code> | ENUM | Sì | <code>v1.0-20250506</code> | <code>v1.0-20250506</code>, <code>v2.0-20260430</code> |
| <code>segmentation_granularity</code> | ENUM | No | <code>balanced</code> | <code>simple</code>, <code>balanced</code>, <code>detailed</code>; v2 only |
| <code>ref_image</code> | IMAGE | No | — | solo v2 |
| <code>split_by_connectivity</code> | BOOLEAN | No | <code>true</code> | solo v2 |

**Output:** STRING <code>model_file</code> + <code>MODEL_INFO</code>. **Prerequisito:** Generate / Import MODEL_INFO. **Errori comuni:** modello/riferimento incompatibile o errore API. **Connessione minima:** Generate / Import → <code>TripoMeshSegmentation</code> → Completion / Preview.

<code>segmentation_granularity</code>, <code>ref_image</code> e <code>split_by_connectivity</code> vengono inviati solo con <code>v2.0-20260430</code>; v1 li ignora.

### TripoMeshCompletion — Tripo: Complete mesh

Completa una mesh segmentata.

| Input | Tipo | Obbligatorio | Predefinito | Valori / intervallo |
| --- | --- | --- | --- | --- |
| <code>model_info</code> | MODEL_INFO | Sì | — | contesto segmentato |
| <code>model_version</code> | ENUM | Sì | <code>v1.0-20250506</code> | <code>v1.0-20250506</code> |
| <code>part_names</code> | STRING multiline | No | vuoto | un nome per riga |

**Output:** STRING <code>model_file</code> + <code>MODEL_INFO</code>. **Prerequisito:** MODEL_INFO segmentato. **Errori comuni:** task non adatto al completamento o errore API. **Connessione minima:** Segment → <code>TripoMeshCompletion</code> → Preview 3D.

### TripoSmartLowPoly — Tripo: Smart low poly

Crea un modello low-poly.

| Input | Tipo | Obbligatorio | Predefinito | Valori / intervallo |
| --- | --- | --- | --- | --- |
| <code>model_info</code> | MODEL_INFO | Sì | — | contesto task a monte |
| <code>model_version</code> | ENUM | Sì | <code>P-v2.0-20251225</code> | <code>P-v2.0-20251225</code> |
| <code>quad</code> | BOOLEAN | No | <code>false</code> | — |
| <code>part_names</code> | STRING multiline | No | vuoto | un nome per riga |
| <code>face_limit</code> | INT | No | <code>10000</code> | <code>-1</code>–<code>20000</code> |
| <code>bake</code> | BOOLEAN | No | <code>true</code> | — |

**Output:** STRING <code>model_file</code> + <code>MODEL_INFO</code>. **Prerequisito:** Generate / Import MODEL_INFO. **Errori comuni:** modello/parti incompatibili o errore API. **Connessione minima:** Generate / Import → <code>TripoSmartLowPoly</code> → Preview / Convert.

### TripoStylizeModel — Tripo: Stylize model

Applica uno stile geometrico.

| Input | Tipo | Obbligatorio | Predefinito | Valori / intervallo |
| --- | --- | --- | --- | --- |
| <code>model_info</code> | MODEL_INFO | Sì | — | contesto task a monte |
| <code>style</code> | ENUM | Sì | primo valore | <code>lego</code>, <code>voxel</code>, <code>voronoi</code>, <code>minecraft</code> |
| <code>block_size</code> | INT | Sì | <code>80</code> | <code>1</code>–<code>1000</code> |

**Output:** STRING <code>model_file</code> + <code>MODEL_INFO</code>. **Prerequisito:** Generate / Import MODEL_INFO. **Errori comuni:** modello/stile incompatibile o errore API. **Connessione minima:** Generate / Import → <code>TripoStylizeModel</code> → Preview 3D.

### Rigging e animazione

### TripoAnimateRigNode — Tripo: Rig model

Esegue il rig automatico.

| Input | Tipo | Obbligatorio | Predefinito | Valori / intervallo |
| --- | --- | --- | --- | --- |
| <code>model_info</code> | MODEL_INFO | Sì | — | contesto task a monte |
| <code>model_version</code> | ENUM | Sì | <code>v2.0-20250506</code> | <code>v1.0-20240301</code>, <code>v2.0-20250506</code> |
| <code>out_format</code> | ENUM | Sì | <code>glb</code> | <code>glb</code>, <code>fbx</code> |
| <code>spec</code> | ENUM | Sì | <code>tripo</code> | <code>mixamo</code>, <code>tripo</code> |

**Output:** STRING <code>model_file</code> + <code>MODEL_INFO</code>. **Prerequisito:** Generate / Import MODEL_INFO. **Errori comuni:** modello non riggabile, rig type assente o errore API. **Connessione minima:** Generate / Import → <code>TripoAnimateRigNode</code> → Retarget / Preview.

Prima del rigging il nodo verifica l’idoneità e ottiene un rig type.

### TripoAnimateRetargetNode — Tripo: Retarget rigged model

Applica un’animazione predefinita.

| Input | Tipo | Obbligatorio | Predefinito | Valori / intervallo |
| --- | --- | --- | --- | --- |
| <code>model_info</code> | MODEL_INFO | Sì | — | contesto con rig |
| <code>animation</code> | ENUM | Sì | primo valore | 16 preset sotto |
| <code>out_format</code> | ENUM | Sì | <code>glb</code> | <code>glb</code>, <code>fbx</code> |
| <code>bake_animation</code> | BOOLEAN | No | <code>true</code> | — |
| <code>export_with_geometry</code> | BOOLEAN | No | <code>false</code> | — |

**Output:** STRING <code>model_file</code> + <code>MODEL_INFO</code>. **Prerequisito:** MODEL_INFO con rig. **Errori comuni:** contesto senza rig o errore API. **Connessione minima:** Rig → <code>TripoAnimateRetargetNode</code> → Preview / Convert.

I 16 valori di animazione sono: <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>.

### Output di formato

### TripoConvertNode — Tripo: Convert model

Converte ed esporta un modello.

| Input | Tipo | Obbligatorio | Predefinito | Valori / intervallo |
| --- | --- | --- | --- | --- |
| <code>model_info</code> | MODEL_INFO | Sì | — | contesto task a monte |
| <code>format</code> | ENUM | Sì | primo valore | <code>GLTF</code>, <code>USDZ</code>, <code>FBX</code>, <code>OBJ</code>, <code>STL</code>, <code>3MF</code> |
| <code>quad</code> | BOOLEAN | No | <code>false</code> | — |
| <code>force_symmetry</code> | BOOLEAN | No | <code>false</code> | — |
| <code>face_limit</code> | INT | No | <code>-1</code> | <code>-1</code>–<code>500000</code> |
| <code>flatten_bottom</code> | BOOLEAN | No | <code>false</code> | — |
| <code>flatten_bottom_threshold</code> | FLOAT | No | <code>0.01</code> | <code>0.0</code>–<code>1.0</code> |
| <code>texture_size</code> | INT | No | <code>4096</code> | <code>128</code>–<code>4096</code> |
| <code>texture_format</code> | ENUM | No | <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 | No | <code>false</code> | — |
| <code>scale_factor</code> | FLOAT | No | <code>1.0</code> | minimo <code>0</code> |
| <code>with_animation</code> | BOOLEAN | No | <code>true</code> | — |
| <code>pack_uv</code> | BOOLEAN | No | <code>false</code> | — |
| <code>bake</code> | BOOLEAN | No | <code>true</code> | — |
| <code>part_names</code> | STRING multiline | No | vuoto | un nome per riga |
| <code>fbx_preset</code> | ENUM | No | <code>blender</code> | <code>blender</code>, <code>mixamo</code>, <code>3dsmax</code> |
| <code>export_vertex_colors</code> | BOOLEAN | No | <code>false</code> | — |
| <code>export_orientation</code> | ENUM | No | <code>+x</code> | <code>+x</code>, <code>+y</code>, <code>-x</code>, <code>-y</code> |
| <code>animate_in_place</code> | BOOLEAN | No | <code>false</code> | — |

**Output:** STRING <code>model_file</code>. **Prerequisito:** MODEL_INFO compatibile. **Errori comuni:** conversione non supportata, opzioni non valide o errore output. **Connessione minima:** MODEL_INFO → <code>TripoConvertNode</code>.

Convert è un nodo di output e non restituisce <code>MODEL_INFO</code>.

## Esempi di workflow

Preview 3D è solo un visualizzatore ComfyUI opzionale.

~~~mermaid
flowchart LR
    T["Testo"] --> GT["Generate model<br/>mode: text_to_model"]
    IM["Immagine"] --> GI["Generate model<br/>mode: image_to_model"]
    MV["Fronte + viste opzionali"] --> GM["Generate model<br/>mode: multiview_to_model"]
    GT --> V["Preview 3D"]
    GI --> V
    GM --> V
~~~

1. **Text to Model:** <code>prompt</code> → Generate con <code>text_to_model</code> → Preview 3D.
2. **Image to Model:** IMAGE → <code>image</code>, modo <code>image_to_model</code> → Preview 3D.
3. **Multiview to Model:** fronte a <code>image</code>; viste opzionali a <code>image_left</code>, <code>image_back</code>, <code>image_right</code>.
4. **Texture Model:** Generate/Import → MODEL_INFO → Texture → Preview.
5. **Refine Model:** bozza compatibile → MODEL_INFO → Refine → Preview.
6. **Rig and Retarget:** Generate/Import → Rig → Retarget collegando MODEL_INFO.
7. **Import and Process:** file/URL → Import → Segment/Smart low poly/Stylize/Texture.
8. **Convert and Export:** MODEL_INFO finale → Convert → formato.

### PNG ufficiali dei workflow

I sei PNG seguenti contengono dati workflow ComfyUI incorporati. Salva l’originale dal link di download, poi trascinalo in ComfyUI o caricalo manualmente. I valori dei parametri mostrati nelle immagini sono solo esempi; usa le tabelle dei parametri per i valori predefiniti attuali.

#### Text to Mesh

![Workflow da testo a mesh con Tripo Generate model e Preview 3D](/assets/images/docs/comfyui-nodes/text_to_model.png)

Genera un modello dal testo e invia <code>model_file</code> a Preview 3D.

<a href="/assets/images/docs/comfyui-nodes/text_to_model.png" download>Scarica il PNG originale del workflow</a>

#### Image to Mesh

![Workflow da immagine a mesh con Load Image, Tripo Generate model e Preview 3D](/assets/images/docs/comfyui-nodes/image_to_model.png)

Carica un’immagine, collegala a Generate model in modalità <code>image_to_model</code> e mostra il risultato.

<a href="/assets/images/docs/comfyui-nodes/image_to_model.png" download>Scarica il PNG originale del workflow</a>

#### Multiview Images to Mesh

![Workflow multivista con tre nodi Load Image, Tripo Generate model e Preview 3D](/assets/images/docs/comfyui-nodes/multiview_to_model.png)

Collega la vista frontale e le viste laterali opzionali a Generate model in modalità <code>multiview_to_model</code>.

<a href="/assets/images/docs/comfyui-nodes/multiview_to_model.png" download>Scarica il PNG originale del workflow</a>

#### Texture a generated model

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

Passa <code>MODEL_INFO</code> da Generate model a Texture model e mostra entrambi gli output.

<a href="/assets/images/docs/comfyui-nodes/texture_model.png" download>Scarica il PNG originale del workflow</a>

#### Refine a draft Mesh

![Workflow di refine con Generate model, Refine Draft model e Preview 3D](/assets/images/docs/comfyui-nodes/refine_model.png)

Genera una bozza compatibile, passa <code>MODEL_INFO</code> a Refine Draft model e mostra il risultato.

<a href="/assets/images/docs/comfyui-nodes/refine_model.png" download>Scarica il PNG originale del workflow</a>

#### Animation / Rig and export

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

<a href="/assets/images/docs/comfyui-nodes/retarget.png" download>Scarica il PNG originale del workflow</a>

## Output e risoluzione problemi

I download vanno per impostazione predefinita in <code>ComfyUI/output</code>. <code>file_prefix</code> rinomina e <code>output_directory</code> sposta il file; entrambi si propagano in <code>MODEL_INFO</code>.

| Sintomo | Controllo |
| --- | --- |
| API Key mancante | Imposta chiave nodo, <code>TRIPO_API_KEY</code> o <code>config.json</code>. |
| Prompt/fronte mancante | Controlla modo e input condizionale. |
| Import non parte | Fornisci URL raggiungibile o file esistente; l’URL ha priorità. |
| Modello non riggabile | Usa un modello personaggio adatto. |
| Task API fallito | Controlla <code>error_code</code>, <code>error_msg</code>, accesso e saldo. |
| Output non spostabile | Controlla percorso e permessi di scrittura. |
| Nodi assenti | Riavvia ComfyUI e controlla directory e <code>requirements.txt</code>. |
| Upload fallito | Controlla estensione e risposta upload ComfyUI. |