# Nodos de ComfyUI

ComfyUI-Tripo es la extensión oficial de nodos personalizados de Tripo para ComfyUI. Integra en los flujos de trabajo de ComfyUI la generación 3D a partir de texto, imágenes o vistas múltiples, junto con la importación de modelos, el texturizado, el refinamiento, el procesamiento de mallas, la optimización low-poly, la estilización, el rigging, el retargeting de animaciones, la conversión de formatos y la retopología.

| Elemento | Valor |
| --- | --- |
| Versión del proyecto Node | <code>1.3.0</code> |
| Etiqueta del código | <code>v1.3.1.1</code> |
| Repositorio | [VAST-AI-Research/ComfyUI-Tripo](https://github.com/VAST-AI-Research/ComfyUI-Tripo) |

## Funciones y registro de cambios

### Funciones

- Generar modelos 3D a partir de texto.
- Generar modelos 3D a partir de imágenes.
- Importar modelos desde una URL mediante <code>model_url</code>.
- Admite la separación de partes del modelo.
- Preparar esqueletos y animar modelos 3D.
- Convertir formatos y retopologizar modelos.

### Registro de cambios

- 2026-06-30: se añadió Mesh Segmentation v2.0 para separar modelos en piezas y la importación directa por URL mediante <code>model_url</code>.
- 2026-05-28: se añadió la importación de modelos.
- 2025-06-19: se actualizó a la API más reciente y se añadieron más nodos.
- 2025-03-31: se adoptó el paquete <code>tripo3d</code>.
- 2025-02-24: se eliminó <code>glbviewer</code>.
- 2025-02-01: se adaptó la nueva API y se adoptó Preview 3D para visualizar modelos.
- 2024-11-11: se adaptó la nueva API.
- 2024-10-14: se añadió la conversión de modelos.
- 2024-09-13: se añadió compatibilidad con <code>model_version</code> <code>v2.0-20240919</code>.

## Instalación

Herramientas oficiales: [ComfyUI-Manager](https://github.com/ltdrdata/ComfyUI-Manager), [Comfy Registry](https://registry.comfy.org/) y [comfy-cli](https://github.com/Comfy-Org/comfy-cli).

**Elige un método** y reinicia ComfyUI al terminar.

1. **ComfyUI-Manager:** Busca <code>Tripo for ComfyUI</code> en Custom Nodes Manager e instálalo.
2. **comfy-cli:**

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

3. **Desde el código fuente:**

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

## Configuración de la API Key

Crea primero una API Key en la [plataforma de Tripo](https://platform.tripo3d.ai/) y configúrala con uno de los siguientes métodos.

La clave se resuelve en este orden:

1. Entrada <code>apikey</code> no vacía del nodo.
2. Variable de entorno <code>TRIPO_API_KEY</code>.
3. Campo <code>TRIPO_API_KEY</code> de <code>config.json</code> en el directorio del proyecto.

Generate e Import muestran <code>apikey</code>; los nodos posteriores reciben la clave resuelta mediante <code>MODEL_INFO</code>. No expongas claves reales en capturas, workflows, registros ni repositorios.

### Ejemplos de inicio con variable de entorno

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

## Resumen de nodos

ComfyUI-Tripo proporciona los siguientes 11 nodos de Tripo:

| Internal ID | Display name | Capacidad | Salida |
| --- | --- | --- | --- |
| <code>TripoAPIDraft</code> | Tripo: Generate model | Genera modelos desde texto, imagen o varias vistas. | STRING <code>model_file</code> + <code>MODEL_INFO</code> |
| <code>TripoImportModel</code> | Tripo: Import model | Importa un modelo local o una URL. | <code>MODEL_INFO</code> |
| <code>TripoTextureModel</code> | Tripo: Texture model | Aplica texturas a un modelo. | STRING <code>model_file</code> + <code>MODEL_INFO</code> |
| <code>TripoRefineModel</code> | Tripo: Refine Draft model | Refina un borrador compatible. | STRING <code>model_file</code> + <code>MODEL_INFO</code> |
| <code>TripoMeshSegmentation</code> | Tripo: Segment mesh | Segmenta una malla. | STRING <code>model_file</code> + <code>MODEL_INFO</code> |
| <code>TripoMeshCompletion</code> | Tripo: Complete mesh | Completa una malla segmentada. | STRING <code>model_file</code> + <code>MODEL_INFO</code> |
| <code>TripoSmartLowPoly</code> | Tripo: Smart low poly | Crea un modelo low-poly. | STRING <code>model_file</code> + <code>MODEL_INFO</code> |
| <code>TripoStylizeModel</code> | Tripo: Stylize model | Aplica un estilo geométrico. | STRING <code>model_file</code> + <code>MODEL_INFO</code> |
| <code>TripoAnimateRigNode</code> | Tripo: Rig model | Hace rigging automático. | STRING <code>model_file</code> + <code>MODEL_INFO</code> |
| <code>TripoAnimateRetargetNode</code> | Tripo: Retarget rigged model | Aplica una animación predefinida. | STRING <code>model_file</code> + <code>MODEL_INFO</code> |
| <code>TripoConvertNode</code> | Tripo: Convert model | Convierte y exporta un modelo. | STRING <code>model_file</code> |

Preview 3D pertenece a ComfyUI y no cuenta entre los 11 nodos de Tripo.

## Conexiones y flujo de datos

~~~mermaid
flowchart LR
    G["Generate model"] -->|MODEL_INFO| P["Procesamiento del modelo"]
    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> es la ruta del archivo descargado para previsualización o procesamiento.
- <code>MODEL_INFO</code> contiene <code>task_id</code>, <code>apikey</code> resuelta, <code>file_prefix</code> y <code>output_directory</code>.
- Un modelo externo debe pasar primero por <code>TripoImportModel</code>; una ruta no sustituye a <code>MODEL_INFO</code>.
- Conecta <code>MODEL_INFO</code> para continuar el procesamiento de Tripo.

## Referencia completa de nodos

“Obligatorio” identifica las entradas requeridas por la definición del nodo. Un <code>apikey</code> vacío puede usar el entorno o la configuración. Un guion indica que no hay un valor predeterminado explícito.

### Generación e importación

### TripoAPIDraft — Tripo: Generate model

Genera modelos desde texto, imagen o varias vistas.

| Entrada | Tipo | Obligatorio | Predeterminado | Valores / rango |
| --- | --- | --- | --- | --- |
| <code>mode</code> | ENUM | Sí | primer valor | <code>text_to_model</code>, <code>image_to_model</code>, <code>multiview_to_model</code> |
| <code>apikey</code> | STRING | Sí | vacío | API key o configuración alternativa |
| <code>prompt</code> | STRING multiline | No | vacío | <code>text_to_model</code> |
| <code>negative_prompt</code> | STRING multiline | No | vacío | — |
| <code>image</code> | IMAGE | No | — | <code>image_to_model</code> origen; <code>multiview_to_model</code> vista frontal |
| <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 se trata como no definido |
| <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>; modos image/multiview |
| <code>file_prefix</code> | STRING | No | vacío | — |
| <code>output_directory</code> | STRING | No | vacío | — |

**Salida:** STRING <code>model_file</code> + <code>MODEL_INFO</code>. **Requisito previo:** ninguno. **Fallos habituales:** falta entrada condicional/clave, falla API o movimiento de salida. **Conexión mínima:** Texto/imagen → <code>TripoAPIDraft</code> → Preview 3D.

Los tres modos tienen estas entradas condicionales:

| <code>mode</code> | Obligatorio según modo | Nota |
| --- | --- | --- |
| <code>text_to_model</code> | <code>prompt</code> | <code>prompt</code> no puede estar vacío. |
| <code>image_to_model</code> | <code>image</code> | Se requiere <code>image</code>. |
| <code>multiview_to_model</code> | <code>image</code> | <code>image</code> es la vista frontal; izquierda, posterior y derecha son opcionales. |

### TripoImportModel — Tripo: Import model

Importa un modelo local o una URL.

| Entrada | Tipo | Obligatorio | Predeterminado | Valores / rango |
| --- | --- | --- | --- | --- |
| <code>apikey</code> | STRING | Sí | vacío | API key o configuración alternativa |
| <code>model_file</code> | file selector | No | <code>none</code> | directorio input de ComfyUI |
| <code>model_url</code> | STRING | No | vacío | URL directa |
| <code>file_prefix</code> | STRING | No | vacío | se propaga |
| <code>output_directory</code> | STRING | No | vacío | se propaga |

**Salida:** <code>MODEL_INFO</code>. **Requisito previo:** archivo local o URL. **Fallos habituales:** falta fuente, URL inaccesible, formato rechazado o importación fallida. **Conexión mínima:** archivo local o URL → <code>TripoImportModel</code> → MODEL_INFO.

Un <code>model_url</code> no vacío tiene prioridad sobre <code>model_file</code>. Sin ambos, el nodo falla. La carga acepta <code>.glb</code>, <code>.fbx</code>, <code>.obj</code>, <code>.stl</code>, <code>.ply</code>, <code>.3mf</code> y <code>.gltf</code>; el backend también detecta <code>.zip</code>.

### Procesamiento del modelo

### TripoTextureModel — Tripo: Texture model

Aplica texturas a un modelo.

| Entrada | Tipo | Obligatorio | Predeterminado | Valores / rango |
| --- | --- | --- | --- | --- |
| <code>model_info</code> | MODEL_INFO | Sí | — | contexto de tarea anterior |
| <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 | vacío | — |
| <code>image_prompt</code> | IMAGE | No | — | — |
| <code>style_image</code> | IMAGE | No | — | — |
| <code>part_names</code> | STRING multiline | No | vacío | one name per line |
| <code>compress</code> | BOOLEAN | No | <code>false</code> | — |
| <code>bake</code> | BOOLEAN | No | <code>true</code> | — |

**Salida:** STRING <code>model_file</code> + <code>MODEL_INFO</code>. **Requisito previo:** Generate / Import MODEL_INFO. **Fallos habituales:** contexto incompatible, imagen no válida o fallo de API. **Conexión mínima:** Generate / Import → <code>TripoTextureModel</code> → Preview 3D.

### TripoRefineModel — Tripo: Refine Draft model

Refina un borrador compatible.

| Entrada | Tipo | Obligatorio | Predeterminado | Valores / rango |
| --- | --- | --- | --- | --- |
| <code>model_info</code> | MODEL_INFO | Sí | — | contexto de borrador |

**Salida:** STRING <code>model_file</code> + <code>MODEL_INFO</code>. **Requisito previo:** MODEL_INFO de un borrador refinable. **Fallos habituales:** borrador no refinable o fallo de API. **Conexión mínima:** Generate draft → <code>TripoRefineModel</code> → Preview 3D.

### TripoMeshSegmentation — Tripo: Segment mesh

Segmenta una malla.

| Entrada | Tipo | Obligatorio | Predeterminado | Valores / rango |
| --- | --- | --- | --- | --- |
| <code>model_info</code> | MODEL_INFO | Sí | — | contexto de tarea anterior |
| <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>; solo v2 |
| <code>ref_image</code> | IMAGE | No | — | solo v2 |
| <code>split_by_connectivity</code> | BOOLEAN | No | <code>true</code> | solo v2 |

**Salida:** STRING <code>model_file</code> + <code>MODEL_INFO</code>. **Requisito previo:** Generate / Import MODEL_INFO. **Fallos habituales:** modelo/referencia incompatible o fallo de API. **Conexión mínima:** Generate / Import → <code>TripoMeshSegmentation</code> → Completion / Preview.

<code>segmentation_granularity</code>, <code>ref_image</code> y <code>split_by_connectivity</code> solo se envían con <code>v2.0-20260430</code>; v1 los ignora.

### TripoMeshCompletion — Tripo: Complete mesh

Completa una malla segmentada.

| Entrada | Tipo | Obligatorio | Predeterminado | Valores / rango |
| --- | --- | --- | --- | --- |
| <code>model_info</code> | MODEL_INFO | Sí | — | contexto segmentado |
| <code>model_version</code> | ENUM | Sí | <code>v1.0-20250506</code> | <code>v1.0-20250506</code> |
| <code>part_names</code> | STRING multiline | No | vacío | one name per line |

**Salida:** STRING <code>model_file</code> + <code>MODEL_INFO</code>. **Requisito previo:** MODEL_INFO segmentado. **Fallos habituales:** tarea no apta para completar o fallo de API. **Conexión mínima:** Segment → <code>TripoMeshCompletion</code> → Preview 3D.

### TripoSmartLowPoly — Tripo: Smart low poly

Crea un modelo low-poly.

| Entrada | Tipo | Obligatorio | Predeterminado | Valores / rango |
| --- | --- | --- | --- | --- |
| <code>model_info</code> | MODEL_INFO | Sí | — | contexto de tarea anterior |
| <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 | vacío | one name per line |
| <code>face_limit</code> | INT | No | <code>10000</code> | <code>-1</code>–<code>20000</code> |
| <code>bake</code> | BOOLEAN | No | <code>true</code> | — |

**Salida:** STRING <code>model_file</code> + <code>MODEL_INFO</code>. **Requisito previo:** Generate / Import MODEL_INFO. **Fallos habituales:** modelo/partes incompatibles o fallo de API. **Conexión mínima:** Generate / Import → <code>TripoSmartLowPoly</code> → Preview / Convert.

### TripoStylizeModel — Tripo: Stylize model

Aplica un estilo geométrico.

| Entrada | Tipo | Obligatorio | Predeterminado | Valores / rango |
| --- | --- | --- | --- | --- |
| <code>model_info</code> | MODEL_INFO | Sí | — | contexto de tarea anterior |
| <code>style</code> | ENUM | Sí | primer valor | <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> |

**Salida:** STRING <code>model_file</code> + <code>MODEL_INFO</code>. **Requisito previo:** Generate / Import MODEL_INFO. **Fallos habituales:** modelo/estilo incompatible o fallo de API. **Conexión mínima:** Generate / Import → <code>TripoStylizeModel</code> → Preview 3D.

### Rigging y animación

### TripoAnimateRigNode — Tripo: Rig model

Hace rigging automático.

| Entrada | Tipo | Obligatorio | Predeterminado | Valores / rango |
| --- | --- | --- | --- | --- |
| <code>model_info</code> | MODEL_INFO | Sí | — | contexto de tarea anterior |
| <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> |

**Salida:** STRING <code>model_file</code> + <code>MODEL_INFO</code>. **Requisito previo:** Generate / Import MODEL_INFO. **Fallos habituales:** modelo no apto, sin rig type o fallo de API. **Conexión mínima:** Generate / Import → <code>TripoAnimateRigNode</code> → Retarget / Preview.

Antes del rigging, el nodo comprueba si el modelo es apto y obtiene un rig type.

### TripoAnimateRetargetNode — Tripo: Retarget rigged model

Aplica una animación predefinida.

| Entrada | Tipo | Obligatorio | Predeterminado | Valores / rango |
| --- | --- | --- | --- | --- |
| <code>model_info</code> | MODEL_INFO | Sí | — | contexto con rig |
| <code>animation</code> | ENUM | Sí | primer valor | 16 presets siguientes |
| <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> | — |

**Salida:** STRING <code>model_file</code> + <code>MODEL_INFO</code>. **Requisito previo:** MODEL_INFO con rig. **Fallos habituales:** contexto sin rig o fallo de API. **Conexión mínima:** Rig → <code>TripoAnimateRetargetNode</code> → Preview / Convert.

Los 16 valores de animación son: <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>.

### Salida de formato

### TripoConvertNode — Tripo: Convert model

Convierte y exporta un modelo.

| Entrada | Tipo | Obligatorio | Predeterminado | Valores / rango |
| --- | --- | --- | --- | --- |
| <code>model_info</code> | MODEL_INFO | Sí | — | contexto de tarea anterior |
| <code>format</code> | ENUM | Sí | primer valor | <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> | minimum <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 | vacío | one name per line |
| <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> | — |

**Salida:** STRING <code>model_file</code>. **Requisito previo:** MODEL_INFO compatible. **Fallos habituales:** conversión no compatible, ajustes inválidos o fallo de salida. **Conexión mínima:** MODEL_INFO → <code>TripoConvertNode</code>.

Convert es un nodo de salida y no devuelve <code>MODEL_INFO</code>.

## Ejemplos de workflows

Preview 3D es solo un visor opcional de ComfyUI.

~~~mermaid
flowchart LR
    T["Texto"] --> GT["Generate model<br/>mode: text_to_model"]
    IM["Imagen"] --> GI["Generate model<br/>mode: image_to_model"]
    MV["Frontal + vistas opcionales"] --> 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:** frontal a <code>image</code>; vistas opcionales a <code>image_left</code>, <code>image_back</code> y <code>image_right</code>.
4. **Texture Model:** Generate/Import → MODEL_INFO → Texture → Preview.
5. **Refine Model:** borrador compatible → MODEL_INFO → Refine → Preview.
6. **Rig and Retarget:** Generate/Import → Rig → Retarget, conectando MODEL_INFO.
7. **Import and Process:** archivo/URL → Import → Segment/Smart low poly/Stylize/Texture.
8. **Convert and Export:** MODEL_INFO final → Convert → elegir formato.

### PNG oficiales de workflows

Los seis PNG siguientes incluyen datos de workflow de ComfyUI. Guarda el original mediante el enlace de descarga y arrástralo a ComfyUI o cárgalo manualmente. Los valores de los parámetros que aparecen en las imágenes son solo ejemplos; consulta las tablas de parámetros para conocer los valores predeterminados actuales.

#### Text to Mesh

![Workflow de texto a malla con Tripo Generate model y Preview 3D](/assets/images/docs/comfyui-nodes/text_to_model.png)

Genera un modelo desde texto y envía <code>model_file</code> a Preview 3D.

<a href="/assets/images/docs/comfyui-nodes/text_to_model.png" download>Descargar el PNG original del workflow</a>

#### Image to Mesh

![Workflow de imagen a malla con Load Image, Tripo Generate model y Preview 3D](/assets/images/docs/comfyui-nodes/image_to_model.png)

Carga una imagen, conéctala a Generate model en modo <code>image_to_model</code> y previsualiza el resultado.

<a href="/assets/images/docs/comfyui-nodes/image_to_model.png" download>Descargar el PNG original del workflow</a>

#### Multiview Images to Mesh

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

Conecta las vistas frontal y laterales opcionales a Generate model en modo <code>multiview_to_model</code>.

<a href="/assets/images/docs/comfyui-nodes/multiview_to_model.png" download>Descargar el PNG original del workflow</a>

#### Texture a generated model

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

Pasa <code>MODEL_INFO</code> de Generate model a Texture model y previsualiza ambas salidas.

<a href="/assets/images/docs/comfyui-nodes/texture_model.png" download>Descargar el PNG original del workflow</a>

#### Refine a draft Mesh

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

Genera un borrador compatible, pasa <code>MODEL_INFO</code> a Refine Draft model y previsualiza el resultado.

<a href="/assets/images/docs/comfyui-nodes/refine_model.png" download>Descargar el PNG original del workflow</a>

#### Animation / Rig and export

![Workflow de rig y exportación con Generate model, Rig model, Preview 3D y Convert model](/assets/images/docs/comfyui-nodes/retarget.png)

<a href="/assets/images/docs/comfyui-nodes/retarget.png" download>Descargar el PNG original del workflow</a>

## Salida y solución de problemas

Las descargas se guardan por defecto en <code>ComfyUI/output</code>. <code>file_prefix</code> cambia el nombre y <code>output_directory</code> mueve el archivo; ambos se propagan en <code>MODEL_INFO</code>.

| Síntoma | Comprobación |
| --- | --- |
| Falta API Key | Configura la clave del nodo, <code>TRIPO_API_KEY</code> o <code>config.json</code>. |
| Falta prompt/frontal | Comprueba el modo y su entrada condicional. |
| Import no inicia | Usa una URL accesible o un archivo existente; la URL tiene prioridad. |
| Modelo no apto para rig | Usa un modelo de personaje adecuado. |
| Falla la tarea API | Revisa <code>error_code</code>, <code>error_msg</code>, acceso y saldo. |
| No se puede mover la salida | Revisa ruta y permisos de escritura. |
| No aparecen nodos | Reinicia ComfyUI y revisa directorio y <code>requirements.txt</code>. |
| Falla la carga | Revisa extensión y respuesta de carga de ComfyUI. |
