# Nós do ComfyUI

ComfyUI-Tripo é a extensão oficial de nós personalizados da Tripo para o ComfyUI. Ela integra aos fluxos de trabalho do ComfyUI a geração 3D a partir de texto, imagens ou várias vistas, além de importação de modelos, texturização, refinamento, processamento de malhas, otimização low-poly, estilização, rigging, redirecionamento de animações, conversão de formatos e retopologia.

| Item | Valor |
| --- | --- |
| Versão do projeto Node | <code>1.3.0</code> |
| Tag do código | <code>v1.3.1.1</code> |
| Repositório | [VAST-AI-Research/ComfyUI-Tripo](https://github.com/VAST-AI-Research/ComfyUI-Tripo) |

## Recursos e registro de alterações

### Recursos

- Gerar modelos 3D a partir de texto.
- Gerar modelos 3D a partir de imagens.
- Importar modelos de uma URL por <code>model_url</code>.
- Oferece suporte à separação de partes do modelo.
- Criar rig e animar modelos 3D.
- Converter formatos e refazer a topologia.

### Registro de alterações

- 2026-06-30: adicionados Mesh Segmentation v2.0 para separar modelos em partes e importação direta por URL com <code>model_url</code>.
- 2026-05-28: adicionada importação de modelos.
- 2025-06-19: atualização para a API mais recente e adição de nós.
- 2025-03-31: adoção do pacote <code>tripo3d</code>.
- 2025-02-24: remoção de <code>glbviewer</code>.
- 2025-02-01: adaptação à nova API e uso de Preview 3D para visualizar modelos.
- 2024-11-11: adaptação à nova API.
- 2024-10-14: adição de conversão de modelos.
- 2024-09-13: suporte a <code>model_version</code> <code>v2.0-20240919</code>.

## Instalação

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

**Escolha um método** e reinicie o ComfyUI.

1. **ComfyUI-Manager:** Pesquise <code>Tripo for ComfyUI</code> no Custom Nodes Manager e instale.
2. **comfy-cli:**

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

3. **A partir do código:**

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

## Configuração da API Key

Crie primeiro uma API Key na [plataforma Tripo](https://platform.tripo3d.ai/) e configure-a com um dos métodos abaixo.

A chave é resolvida nesta ordem:

1. Entrada <code>apikey</code> não vazia no nó.
2. Variável de ambiente <code>TRIPO_API_KEY</code>.
3. Campo <code>TRIPO_API_KEY</code> do <code>config.json</code> no diretório do projeto.

Generate e Import expõem <code>apikey</code>; os nós seguintes recebem a chave via <code>MODEL_INFO</code>. Não exponha chaves reais em capturas, workflows, logs ou repositórios.

### Exemplos de inicialização com variável de ambiente

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

## Visão geral dos nós

O ComfyUI-Tripo oferece os 11 nós Tripo a seguir:

| ID interno | Nome exibido | Capacidade | Saída |
| --- | --- | --- | --- |
| <code>TripoAPIDraft</code> | Tripo: Generate model | Gera modelos a partir de texto, imagem ou várias vistas. | STRING <code>model_file</code> + <code>MODEL_INFO</code> |
| <code>TripoImportModel</code> | Tripo: Import model | Importa modelo local ou URL. | <code>MODEL_INFO</code> |
| <code>TripoTextureModel</code> | Tripo: Texture model | Aplica textura a um modelo. | STRING <code>model_file</code> + <code>MODEL_INFO</code> |
| <code>TripoRefineModel</code> | Tripo: Refine Draft model | Refina um rascunho compatível. | STRING <code>model_file</code> + <code>MODEL_INFO</code> |
| <code>TripoMeshSegmentation</code> | Tripo: Segment mesh | Segmenta uma malha. | STRING <code>model_file</code> + <code>MODEL_INFO</code> |
| <code>TripoMeshCompletion</code> | Tripo: Complete mesh | Completa uma malha segmentada. | STRING <code>model_file</code> + <code>MODEL_INFO</code> |
| <code>TripoSmartLowPoly</code> | Tripo: Smart low poly | Cria um modelo low-poly. | STRING <code>model_file</code> + <code>MODEL_INFO</code> |
| <code>TripoStylizeModel</code> | Tripo: Stylize model | Aplica estilo geométrico. | STRING <code>model_file</code> + <code>MODEL_INFO</code> |
| <code>TripoAnimateRigNode</code> | Tripo: Rig model | Faz rig automático. | STRING <code>model_file</code> + <code>MODEL_INFO</code> |
| <code>TripoAnimateRetargetNode</code> | Tripo: Retarget rigged model | Aplica animação predefinida. | STRING <code>model_file</code> + <code>MODEL_INFO</code> |
| <code>TripoConvertNode</code> | Tripo: Convert model | Converte e exporta um modelo. | STRING <code>model_file</code> |

Preview 3D é fornecido pelo ComfyUI e não conta entre os 11 nós Tripo.

## Conexões e fluxo de dados

~~~mermaid
flowchart LR
    G["Generate model"] -->|MODEL_INFO| P["Processamento do 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> é o caminho do arquivo baixado para prévia ou manipulação.
- <code>MODEL_INFO</code> contém <code>task_id</code>, <code>apikey</code> resolvida, <code>file_prefix</code> e <code>output_directory</code>.
- Um modelo externo deve passar primeiro por <code>TripoImportModel</code>; um caminho não substitui <code>MODEL_INFO</code>.
- Conecte <code>MODEL_INFO</code> para continuar o processamento Tripo.

## Referência completa dos nós

“Obrigatório” identifica as entradas exigidas pela definição do nó. Um <code>apikey</code> vazio pode usar o ambiente ou a configuração. Um travessão indica que não há valor padrão explícito.

### Geração e importação

### TripoAPIDraft — Tripo: Generate model

Gera modelos a partir de texto, imagem ou várias vistas.

| Entrada | Tipo | Obrigatório | Padrão | Valores / intervalo |
| --- | --- | --- | --- | --- |
| <code>mode</code> | ENUM | Sim | primeiro valor | <code>text_to_model</code>, <code>image_to_model</code>, <code>multiview_to_model</code> |
| <code>apikey</code> | STRING | Sim | vazio | API key ou fallback |
| <code>prompt</code> | STRING multiline | Não | vazio | <code>text_to_model</code> |
| <code>negative_prompt</code> | STRING multiline | Não | vazio | — |
| <code>image</code> | IMAGE | Não | — | <code>image_to_model</code> origem; <code>multiview_to_model</code> vista frontal |
| <code>image_left</code> | IMAGE | Não | — | <code>multiview_to_model</code> |
| <code>image_back</code> | IMAGE | Não | — | <code>multiview_to_model</code> |
| <code>image_right</code> | IMAGE | Não | — | <code>multiview_to_model</code> |
| <code>model_version</code> | ENUM | Não | <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 | Não | <code>true</code> | — |
| <code>pbr</code> | BOOLEAN | Não | <code>true</code> | — |
| <code>image_seed</code> | INT | Não | <code>42</code> | <code>text_to_model</code> |
| <code>model_seed</code> | INT | Não | <code>42</code> | — |
| <code>texture_seed</code> | INT | Não | <code>42</code> | — |
| <code>texture_quality</code> | ENUM | Não | <code>standard</code> | <code>standard</code>, <code>detailed</code> |
| <code>geometry_quality</code> | ENUM | Não | <code>standard</code> | <code>standard</code>, <code>detailed</code>; <code>image_to_model</code> |
| <code>texture_alignment</code> | ENUM | Não | <code>original_image</code> | <code>original_image</code>, <code>geometry</code> |
| <code>face_limit</code> | INT | Não | <code>-1</code> | <code>-1</code>–<code>500000</code>; ≤ 0 é tratado como não definido |
| <code>quad</code> | BOOLEAN | Não | <code>false</code> | — |
| <code>compress</code> | BOOLEAN | Não | <code>false</code> | — |
| <code>generate_parts</code> | BOOLEAN | Não | <code>false</code> | — |
| <code>smart_low_poly</code> | BOOLEAN | Não | <code>false</code> | — |
| <code>auto_size</code> | BOOLEAN | Não | <code>false</code> | — |
| <code>orientation</code> | ENUM | Não | <code>default</code> | <code>default</code>, <code>align_image</code>; modos imagem/multiview |
| <code>file_prefix</code> | STRING | Não | vazio | — |
| <code>output_directory</code> | STRING | Não | vazio | — |

**Saída:** STRING <code>model_file</code> + <code>MODEL_INFO</code>. **Pré-requisito:** nenhum. **Falhas comuns:** entrada condicional/chave ausente, tarefa API ou movimentação da saída falhou. **Conexão mínima:** Texto/imagem → <code>TripoAPIDraft</code> → Preview 3D.

Os três modos têm estas entradas condicionais:

| <code>mode</code> | Obrigatório por modo | Observação |
| --- | --- | --- |
| <code>text_to_model</code> | <code>prompt</code> | <code>prompt</code> não pode ficar vazio. |
| <code>image_to_model</code> | <code>image</code> | <code>image</code> é obrigatório. |
| <code>multiview_to_model</code> | <code>image</code> | <code>image</code> é a vista frontal; esquerda, traseira e direita são opcionais. |

### TripoImportModel — Tripo: Import model

Importa modelo local ou URL.

| Entrada | Tipo | Obrigatório | Padrão | Valores / intervalo |
| --- | --- | --- | --- | --- |
| <code>apikey</code> | STRING | Sim | vazio | API key ou fallback |
| <code>model_file</code> | file selector | Não | <code>none</code> | diretório de entrada do ComfyUI |
| <code>model_url</code> | STRING | Não | vazio | URL direta |
| <code>file_prefix</code> | STRING | Não | vazio | propagado |
| <code>output_directory</code> | STRING | Não | vazio | propagado |

**Saída:** <code>MODEL_INFO</code>. **Pré-requisito:** arquivo local ou URL. **Falhas comuns:** origem ausente/inacessível, formato rejeitado ou importação falhou. **Conexão mínima:** arquivo local ou URL → <code>TripoImportModel</code> → MODEL_INFO.

Um <code>model_url</code> não vazio tem prioridade sobre <code>model_file</code>. Sem ambos, o nó falha. O upload aceita <code>.glb</code>, <code>.fbx</code>, <code>.obj</code>, <code>.stl</code>, <code>.ply</code>, <code>.3mf</code> e <code>.gltf</code>; o backend também reconhece <code>.zip</code>.

### Processamento do modelo

### TripoTextureModel — Tripo: Texture model

Aplica textura a um modelo.

| Entrada | Tipo | Obrigatório | Padrão | Valores / intervalo |
| --- | --- | --- | --- | --- |
| <code>model_info</code> | MODEL_INFO | Sim | — | contexto da tarefa anterior |
| <code>model_version</code> | ENUM | Não | <code>v3.0-20250812</code> | <code>v2.5-20250123</code>, <code>v3.0-20250812</code> |
| <code>texture</code> | BOOLEAN | Não | <code>true</code> | — |
| <code>pbr</code> | BOOLEAN | Não | <code>true</code> | — |
| <code>texture_seed</code> | INT | Não | <code>42</code> | — |
| <code>texture_quality</code> | ENUM | Não | <code>standard</code> | <code>standard</code>, <code>detailed</code> |
| <code>texture_alignment</code> | ENUM | Não | <code>original_image</code> | <code>original_image</code>, <code>geometry</code> |
| <code>text_prompt</code> | STRING multiline | Não | vazio | — |
| <code>image_prompt</code> | IMAGE | Não | — | — |
| <code>style_image</code> | IMAGE | Não | — | — |
| <code>part_names</code> | STRING multiline | Não | vazio | um nome por linha |
| <code>compress</code> | BOOLEAN | Não | <code>false</code> | — |
| <code>bake</code> | BOOLEAN | Não | <code>true</code> | — |

**Saída:** STRING <code>model_file</code> + <code>MODEL_INFO</code>. **Pré-requisito:** Generate / Import MODEL_INFO. **Falhas comuns:** contexto incompatível, imagem inválida ou falha da API. **Conexão mínima:** Generate / Import → <code>TripoTextureModel</code> → Preview 3D.

### TripoRefineModel — Tripo: Refine Draft model

Refina um rascunho compatível.

| Entrada | Tipo | Obrigatório | Padrão | Valores / intervalo |
| --- | --- | --- | --- | --- |
| <code>model_info</code> | MODEL_INFO | Sim | — | contexto de rascunho |

**Saída:** STRING <code>model_file</code> + <code>MODEL_INFO</code>. **Pré-requisito:** MODEL_INFO de rascunho refinável. **Falhas comuns:** rascunho não refinável ou falha da API. **Conexão mínima:** Generate draft → <code>TripoRefineModel</code> → Preview 3D.

### TripoMeshSegmentation — Tripo: Segment mesh

Segmenta uma malha.

| Entrada | Tipo | Obrigatório | Padrão | Valores / intervalo |
| --- | --- | --- | --- | --- |
| <code>model_info</code> | MODEL_INFO | Sim | — | contexto da tarefa anterior |
| <code>model_version</code> | ENUM | Sim | <code>v1.0-20250506</code> | <code>v1.0-20250506</code>, <code>v2.0-20260430</code> |
| <code>segmentation_granularity</code> | ENUM | Não | <code>balanced</code> | <code>simple</code>, <code>balanced</code>, <code>detailed</code>; v2 only |
| <code>ref_image</code> | IMAGE | Não | — | somente v2 |
| <code>split_by_connectivity</code> | BOOLEAN | Não | <code>true</code> | somente v2 |

**Saída:** STRING <code>model_file</code> + <code>MODEL_INFO</code>. **Pré-requisito:** Generate / Import MODEL_INFO. **Falhas comuns:** modelo/referência incompatível ou falha da API. **Conexão mínima:** Generate / Import → <code>TripoMeshSegmentation</code> → Completion / Preview.

<code>segmentation_granularity</code>, <code>ref_image</code> e <code>split_by_connectivity</code> só são enviados com <code>v2.0-20260430</code>; v1 os ignora.

### TripoMeshCompletion — Tripo: Complete mesh

Completa uma malha segmentada.

| Entrada | Tipo | Obrigatório | Padrão | Valores / intervalo |
| --- | --- | --- | --- | --- |
| <code>model_info</code> | MODEL_INFO | Sim | — | contexto segmentado |
| <code>model_version</code> | ENUM | Sim | <code>v1.0-20250506</code> | <code>v1.0-20250506</code> |
| <code>part_names</code> | STRING multiline | Não | vazio | um nome por linha |

**Saída:** STRING <code>model_file</code> + <code>MODEL_INFO</code>. **Pré-requisito:** MODEL_INFO segmentado. **Falhas comuns:** tarefa inadequada para conclusão ou falha da API. **Conexão mínima:** Segment → <code>TripoMeshCompletion</code> → Preview 3D.

### TripoSmartLowPoly — Tripo: Smart low poly

Cria um modelo low-poly.

| Entrada | Tipo | Obrigatório | Padrão | Valores / intervalo |
| --- | --- | --- | --- | --- |
| <code>model_info</code> | MODEL_INFO | Sim | — | contexto da tarefa anterior |
| <code>model_version</code> | ENUM | Sim | <code>P-v2.0-20251225</code> | <code>P-v2.0-20251225</code> |
| <code>quad</code> | BOOLEAN | Não | <code>false</code> | — |
| <code>part_names</code> | STRING multiline | Não | vazio | um nome por linha |
| <code>face_limit</code> | INT | Não | <code>10000</code> | <code>-1</code>–<code>20000</code> |
| <code>bake</code> | BOOLEAN | Não | <code>true</code> | — |

**Saída:** STRING <code>model_file</code> + <code>MODEL_INFO</code>. **Pré-requisito:** Generate / Import MODEL_INFO. **Falhas comuns:** modelo/partes incompatíveis ou falha da API. **Conexão mínima:** Generate / Import → <code>TripoSmartLowPoly</code> → Preview / Convert.

### TripoStylizeModel — Tripo: Stylize model

Aplica estilo geométrico.

| Entrada | Tipo | Obrigatório | Padrão | Valores / intervalo |
| --- | --- | --- | --- | --- |
| <code>model_info</code> | MODEL_INFO | Sim | — | contexto da tarefa anterior |
| <code>style</code> | ENUM | Sim | primeiro valor | <code>lego</code>, <code>voxel</code>, <code>voronoi</code>, <code>minecraft</code> |
| <code>block_size</code> | INT | Sim | <code>80</code> | <code>1</code>–<code>1000</code> |

**Saída:** STRING <code>model_file</code> + <code>MODEL_INFO</code>. **Pré-requisito:** Generate / Import MODEL_INFO. **Falhas comuns:** modelo/estilo incompatível ou falha da API. **Conexão mínima:** Generate / Import → <code>TripoStylizeModel</code> → Preview 3D.

### Rigging e animação

### TripoAnimateRigNode — Tripo: Rig model

Faz rig automático.

| Entrada | Tipo | Obrigatório | Padrão | Valores / intervalo |
| --- | --- | --- | --- | --- |
| <code>model_info</code> | MODEL_INFO | Sim | — | contexto da tarefa anterior |
| <code>model_version</code> | ENUM | Sim | <code>v2.0-20250506</code> | <code>v1.0-20240301</code>, <code>v2.0-20250506</code> |
| <code>out_format</code> | ENUM | Sim | <code>glb</code> | <code>glb</code>, <code>fbx</code> |
| <code>spec</code> | ENUM | Sim | <code>tripo</code> | <code>mixamo</code>, <code>tripo</code> |

**Saída:** STRING <code>model_file</code> + <code>MODEL_INFO</code>. **Pré-requisito:** Generate / Import MODEL_INFO. **Falhas comuns:** modelo sem suporte a rig, sem rig type ou falha da API. **Conexão mínima:** Generate / Import → <code>TripoAnimateRigNode</code> → Retarget / Preview.

Antes do rigging, o nó verifica se o modelo é adequado e obtém um rig type.

### TripoAnimateRetargetNode — Tripo: Retarget rigged model

Aplica animação predefinida.

| Entrada | Tipo | Obrigatório | Padrão | Valores / intervalo |
| --- | --- | --- | --- | --- |
| <code>model_info</code> | MODEL_INFO | Sim | — | contexto com rig |
| <code>animation</code> | ENUM | Sim | primeiro valor | 16 presets abaixo |
| <code>out_format</code> | ENUM | Sim | <code>glb</code> | <code>glb</code>, <code>fbx</code> |
| <code>bake_animation</code> | BOOLEAN | Não | <code>true</code> | — |
| <code>export_with_geometry</code> | BOOLEAN | Não | <code>false</code> | — |

**Saída:** STRING <code>model_file</code> + <code>MODEL_INFO</code>. **Pré-requisito:** MODEL_INFO com rig. **Falhas comuns:** contexto sem rig ou falha da API. **Conexão mínima:** Rig → <code>TripoAnimateRetargetNode</code> → Preview / Convert.

Os 16 valores de animação são: <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>.

### Saída de formato

### TripoConvertNode — Tripo: Convert model

Converte e exporta um modelo.

| Entrada | Tipo | Obrigatório | Padrão | Valores / intervalo |
| --- | --- | --- | --- | --- |
| <code>model_info</code> | MODEL_INFO | Sim | — | contexto da tarefa anterior |
| <code>format</code> | ENUM | Sim | primeiro valor | <code>GLTF</code>, <code>USDZ</code>, <code>FBX</code>, <code>OBJ</code>, <code>STL</code>, <code>3MF</code> |
| <code>quad</code> | BOOLEAN | Não | <code>false</code> | — |
| <code>force_symmetry</code> | BOOLEAN | Não | <code>false</code> | — |
| <code>face_limit</code> | INT | Não | <code>-1</code> | <code>-1</code>–<code>500000</code> |
| <code>flatten_bottom</code> | BOOLEAN | Não | <code>false</code> | — |
| <code>flatten_bottom_threshold</code> | FLOAT | Não | <code>0.01</code> | <code>0.0</code>–<code>1.0</code> |
| <code>texture_size</code> | INT | Não | <code>4096</code> | <code>128</code>–<code>4096</code> |
| <code>texture_format</code> | ENUM | Não | <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 | Não | <code>false</code> | — |
| <code>scale_factor</code> | FLOAT | Não | <code>1.0</code> | mínimo <code>0</code> |
| <code>with_animation</code> | BOOLEAN | Não | <code>true</code> | — |
| <code>pack_uv</code> | BOOLEAN | Não | <code>false</code> | — |
| <code>bake</code> | BOOLEAN | Não | <code>true</code> | — |
| <code>part_names</code> | STRING multiline | Não | vazio | um nome por linha |
| <code>fbx_preset</code> | ENUM | Não | <code>blender</code> | <code>blender</code>, <code>mixamo</code>, <code>3dsmax</code> |
| <code>export_vertex_colors</code> | BOOLEAN | Não | <code>false</code> | — |
| <code>export_orientation</code> | ENUM | Não | <code>+x</code> | <code>+x</code>, <code>+y</code>, <code>-x</code>, <code>-y</code> |
| <code>animate_in_place</code> | BOOLEAN | Não | <code>false</code> | — |

**Saída:** STRING <code>model_file</code>. **Pré-requisito:** MODEL_INFO compatível. **Falhas comuns:** conversão sem suporte, opções inválidas ou erro de saída. **Conexão mínima:** MODEL_INFO → <code>TripoConvertNode</code>.

Convert é um nó de saída e não retorna <code>MODEL_INFO</code>.

## Exemplos de workflows

Preview 3D é apenas um visualizador opcional do ComfyUI.

~~~mermaid
flowchart LR
    T["Texto"] --> GT["Generate model<br/>mode: text_to_model"]
    IM["Imagem"] --> GI["Generate model<br/>mode: image_to_model"]
    MV["Frontal + vistas opcionais"] --> GM["Generate model<br/>mode: multiview_to_model"]
    GT --> V["Preview 3D"]
    GI --> V
    GM --> V
~~~

1. **Text to Model:** <code>prompt</code> → Generate com <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 em <code>image</code>; vistas opcionais em <code>image_left</code>, <code>image_back</code> e <code>image_right</code>.
4. **Texture Model:** Generate/Import → MODEL_INFO → Texture → Preview.
5. **Refine Model:** rascunho compatível → MODEL_INFO → Refine → Preview.
6. **Rig and Retarget:** Generate/Import → Rig → Retarget conectando MODEL_INFO.
7. **Import and Process:** arquivo/URL → Import → Segment/Smart low poly/Stylize/Texture.
8. **Convert and Export:** MODEL_INFO final → Convert → formato.

### PNGs oficiais de workflows

Os seis PNGs abaixo contêm dados de workflow do ComfyUI. Salve o original pelo link de download e arraste-o para o ComfyUI ou carregue manualmente. Os valores de parâmetros mostrados nas imagens são apenas exemplos; consulte as tabelas de parâmetros para os padrões atuais.

#### Text to Mesh

![Workflow de texto para malha com Tripo Generate model e Preview 3D](/assets/images/docs/comfyui-nodes/text_to_model.png)

Gera um modelo a partir de texto e envia <code>model_file</code> ao Preview 3D.

<a href="/assets/images/docs/comfyui-nodes/text_to_model.png" download>Baixar o PNG original do workflow</a>

#### Image to Mesh

![Workflow de imagem para malha com Load Image, Tripo Generate model e Preview 3D](/assets/images/docs/comfyui-nodes/image_to_model.png)

Carrega uma imagem, conecta ao Generate model em modo <code>image_to_model</code> e mostra o resultado.

<a href="/assets/images/docs/comfyui-nodes/image_to_model.png" download>Baixar o PNG original do workflow</a>

#### Multiview Images to Mesh

![Workflow multiview com três nós Load Image, Tripo Generate model e Preview 3D](/assets/images/docs/comfyui-nodes/multiview_to_model.png)

Conecta a vista frontal e vistas laterais opcionais ao Generate model em modo <code>multiview_to_model</code>.

<a href="/assets/images/docs/comfyui-nodes/multiview_to_model.png" download>Baixar o PNG original do workflow</a>

#### Texture a generated model

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

Passa <code>MODEL_INFO</code> do Generate model ao Texture model e mostra as duas saídas.

<a href="/assets/images/docs/comfyui-nodes/texture_model.png" download>Baixar o PNG original do workflow</a>

#### Refine a draft Mesh

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

Gera um rascunho compatível, passa <code>MODEL_INFO</code> ao Refine Draft model e mostra o resultado.

<a href="/assets/images/docs/comfyui-nodes/refine_model.png" download>Baixar o PNG original do workflow</a>

#### Animation / Rig and export

![Workflow de rig e exportação com 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>Baixar o PNG original do workflow</a>

## Saída e solução de problemas

Os downloads vão por padrão para <code>ComfyUI/output</code>. <code>file_prefix</code> renomeia e <code>output_directory</code> move o arquivo; ambos são propagados em <code>MODEL_INFO</code>.

| Sintoma | Verificação |
| --- | --- |
| API Key ausente | Defina chave do nó, <code>TRIPO_API_KEY</code> ou <code>config.json</code>. |
| Prompt/frontal ausente | Confira modo e entrada condicional. |
| Import não inicia | Use URL acessível ou arquivo existente; URL tem prioridade. |
| Modelo não aceita rig | Use um modelo de personagem adequado. |
| Tarefa API falhou | Confira <code>error_code</code>, <code>error_msg</code>, acesso e saldo. |
| Saída não pode ser movida | Confira caminho e permissões de escrita. |
| Nós não aparecem | Reinicie o ComfyUI e confira diretório e <code>requirements.txt</code>. |
| Upload falhou | Confira extensão e resposta de upload do ComfyUI. |