# 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  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  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  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  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  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  <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. |

comfy node registry-install comfyui-tripo

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

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

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

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

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