Tripo3D

Nodi ComfyUI

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 1.3.0
Tag sorgente v1.3.1.1
Repository 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 model_url.
  • 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 model_url.
  • 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 tripo3d.
  • 2025-02-24: rimosso glbviewer.
  • 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 model_version v2.0-20240919.

Installazione

Strumenti ufficiali: ComfyUI-Manager, Comfy Registry e comfy-cli.

Scegli un metodo e riavvia ComfyUI.

  1. ComfyUI-Manager: Cerca Tripo for ComfyUI in Custom Nodes Manager e installalo.
  2. comfy-cli:
Bash
comfy node registry-install comfyui-tripo
  1. 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, poi configurala con uno dei metodi seguenti.

La chiave viene risolta in quest’ordine:

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

Generate e Import espongono apikey; i nodi successivi ricevono la chiave tramite MODEL_INFO. 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
TripoAPIDraft Tripo: Generate model Genera modelli da testo, immagine o più viste. STRING model_file + MODEL_INFO
TripoImportModel Tripo: Import model Importa un modello locale o un URL. MODEL_INFO
TripoTextureModel Tripo: Texture model Applica texture a un modello. STRING model_file + MODEL_INFO
TripoRefineModel Tripo: Refine Draft model Rifinisce una bozza compatibile. STRING model_file + MODEL_INFO
TripoMeshSegmentation Tripo: Segment mesh Segmenta una mesh. STRING model_file + MODEL_INFO
TripoMeshCompletion Tripo: Complete mesh Completa una mesh segmentata. STRING model_file + MODEL_INFO
TripoSmartLowPoly Tripo: Smart low poly Crea un modello low-poly. STRING model_file + MODEL_INFO
TripoStylizeModel Tripo: Stylize model Applica uno stile geometrico. STRING model_file + MODEL_INFO
TripoAnimateRigNode Tripo: Rig model Esegue il rig automatico. STRING model_file + MODEL_INFO
TripoAnimateRetargetNode Tripo: Retarget rigged model Applica un’animazione predefinita. STRING model_file + MODEL_INFO
TripoConvertNode Tripo: Convert model Converte ed esporta un modello. STRING model_file

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

Connessioni e flusso dati

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"]
  • model_file è il percorso del file scaricato per anteprima o gestione file.
  • MODEL_INFO contiene task_id, apikey risolta, file_prefix e output_directory.
  • Un modello esterno deve prima passare da TripoImportModel; un percorso file non sostituisce MODEL_INFO.
  • Collega MODEL_INFO per continuare l’elaborazione Tripo.

Riferimento completo dei nodi

“Obbligatorio” indica gli input richiesti dalla definizione del nodo. Un apikey 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
mode ENUM Sì primo valore text_to_model, image_to_model, multiview_to_model
apikey STRING Sì vuoto API key o fallback
prompt STRING multiline No vuoto text_to_model
negative_prompt STRING multiline No vuoto —
image IMAGE No — image_to_model origine; multiview_to_model vista frontale
image_left IMAGE No — multiview_to_model
image_back IMAGE No — multiview_to_model
image_right IMAGE No — multiview_to_model
model_version ENUM No v3.1-20260211 v1.4-20240625, v2.0-20240919, v2.5-20250123, v3.0-20250812, v3.1-20260211
texture BOOLEAN No true —
pbr BOOLEAN No true —
image_seed INT No 42 text_to_model
model_seed INT No 42 —
texture_seed INT No 42 —
texture_quality ENUM No standard standard, detailed
geometry_quality ENUM No standard standard, detailed; image_to_model
texture_alignment ENUM No original_image original_image, geometry
face_limit INT No -1 -1–500000; ≤ 0 equivale a non impostato
quad BOOLEAN No false —
compress BOOLEAN No false —
generate_parts BOOLEAN No false —
smart_low_poly BOOLEAN No false —
auto_size BOOLEAN No false —
orientation ENUM No default default, align_image; modalità immagine/multiview
file_prefix STRING No vuoto —
output_directory STRING No vuoto —

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

I tre modi richiedono questi input condizionali:

mode Obbligatorio per modo Nota
text_to_model prompt prompt non può essere vuoto.
image_to_model image image è richiesto.
multiview_to_model image image è 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
apikey STRING Sì vuoto API key o fallback
model_file file selector No none directory input di ComfyUI
model_url STRING No vuoto URL diretto
file_prefix STRING No vuoto trasmesso ai nodi successivi
output_directory STRING No vuoto trasmesso ai nodi successivi

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

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

Elaborazione modello

TripoTextureModel — Tripo: Texture model

Applica texture a un modello.

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

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

TripoRefineModel — Tripo: Refine Draft model

Rifinisce una bozza compatibile.

Input Tipo Obbligatorio Predefinito Valori / intervallo
model_info MODEL_INFO Sì — contesto bozza

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

TripoMeshSegmentation — Tripo: Segment mesh

Segmenta una mesh.

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

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

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

TripoMeshCompletion — Tripo: Complete mesh

Completa una mesh segmentata.

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

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

TripoSmartLowPoly — Tripo: Smart low poly

Crea un modello low-poly.

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

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

TripoStylizeModel — Tripo: Stylize model

Applica uno stile geometrico.

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

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

Rigging e animazione

TripoAnimateRigNode — Tripo: Rig model

Esegue il rig automatico.

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

Output: STRING model_file + MODEL_INFO. Prerequisito: Generate / Import MODEL_INFO. Errori comuni: modello non riggabile, rig type assente o errore API. Connessione minima: Generate / Import → TripoAnimateRigNode → 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
model_info MODEL_INFO Sì — contesto con rig
animation ENUM Sì primo valore 16 preset sotto
out_format ENUM Sì glb glb, fbx
bake_animation BOOLEAN No true —
export_with_geometry BOOLEAN No false —

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

I 16 valori di animazione sono: preset:idle, preset:walk, preset:run, preset:dive, preset:climb, preset:jump, preset:slash, preset:shoot, preset:hurt, preset:fall, preset:turn, preset:quadruped:walk, preset:hexapod:walk, preset:octopod:walk, preset:serpentine:march, preset:aquatic:march.

Output di formato

TripoConvertNode — Tripo: Convert model

Converte ed esporta un modello.

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

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

Convert è un nodo di output e non restituisce MODEL_INFO.

Esempi di workflow

Preview 3D è solo un visualizzatore ComfyUI opzionale.

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: prompt → Generate con text_to_model → Preview 3D.
  2. Image to Model: IMAGE → image, modo image_to_model → Preview 3D.
  3. Multiview to Model: fronte a image; viste opzionali a image_left, image_back, image_right.
  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

Genera un modello dal testo e invia model_file a Preview 3D.

Scarica il PNG originale del workflow

Image to Mesh

Workflow da immagine a mesh con Load Image, Tripo Generate model e Preview 3D

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

Scarica il PNG originale del workflow

Multiview Images to Mesh

Workflow multivista con tre nodi Load Image, Tripo Generate model e Preview 3D

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

Scarica il PNG originale del workflow

Texture a generated model

Workflow texture con Generate model, Texture model e Preview 3D

Passa MODEL_INFO da Generate model a Texture model e mostra entrambi gli output.

Scarica il PNG originale del workflow

Refine a draft Mesh

Workflow di refine con Generate model, Refine Draft model e Preview 3D

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

Scarica il PNG originale del workflow

Animation / Rig and export

Workflow rig ed export con Generate model, Rig model, Preview 3D e Convert model

Scarica il PNG originale del workflow

Output e risoluzione problemi

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

Sintomo Controllo
API Key mancante Imposta chiave nodo, TRIPO_API_KEY o config.json.
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 error_code, error_msg, accesso e saldo.
Output non spostabile Controlla percorso e permessi di scrittura.
Nodi assenti Riavvia ComfyUI e controlla directory e requirements.txt.
Upload fallito Controlla estensione e risposta upload ComfyUI.