Tripo3D

Nodos de ComfyUI

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 1.3.0
Etiqueta del código v1.3.1.1
Repositorio 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 model_url.
  • 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 model_url.
  • 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 tripo3d.
  • 2025-02-24: se eliminó glbviewer.
  • 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 model_version v2.0-20240919.

Instalación

Herramientas oficiales: ComfyUI-Manager, Comfy Registry y comfy-cli.

Elige un método y reinicia ComfyUI al terminar.

  1. ComfyUI-Manager: Busca Tripo for ComfyUI en Custom Nodes Manager e instálalo.
  2. comfy-cli:
Bash
comfy node registry-install comfyui-tripo
  1. 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 y configúrala con uno de los siguientes métodos.

La clave se resuelve en este orden:

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

Generate e Import muestran apikey; los nodos posteriores reciben la clave resuelta mediante MODEL_INFO. 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
TripoAPIDraft Tripo: Generate model Genera modelos desde texto, imagen o varias vistas. STRING model_file + MODEL_INFO
TripoImportModel Tripo: Import model Importa un modelo local o una URL. MODEL_INFO
TripoTextureModel Tripo: Texture model Aplica texturas a un modelo. STRING model_file + MODEL_INFO
TripoRefineModel Tripo: Refine Draft model Refina un borrador compatible. STRING model_file + MODEL_INFO
TripoMeshSegmentation Tripo: Segment mesh Segmenta una malla. STRING model_file + MODEL_INFO
TripoMeshCompletion Tripo: Complete mesh Completa una malla segmentada. STRING model_file + MODEL_INFO
TripoSmartLowPoly Tripo: Smart low poly Crea un modelo low-poly. STRING model_file + MODEL_INFO
TripoStylizeModel Tripo: Stylize model Aplica un estilo geométrico. STRING model_file + MODEL_INFO
TripoAnimateRigNode Tripo: Rig model Hace rigging automático. STRING model_file + MODEL_INFO
TripoAnimateRetargetNode Tripo: Retarget rigged model Aplica una animación predefinida. STRING model_file + MODEL_INFO
TripoConvertNode Tripo: Convert model Convierte y exporta un modelo. STRING model_file

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

Conexiones y flujo de datos

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"]
  • model_file es la ruta del archivo descargado para previsualización o procesamiento.
  • MODEL_INFO contiene task_id, apikey resuelta, file_prefix y output_directory.
  • Un modelo externo debe pasar primero por TripoImportModel; una ruta no sustituye a MODEL_INFO.
  • Conecta MODEL_INFO para continuar el procesamiento de Tripo.

Referencia completa de nodos

“Obligatorio” identifica las entradas requeridas por la definición del nodo. Un apikey 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
mode ENUM Sí primer valor text_to_model, image_to_model, multiview_to_model
apikey STRING Sí vacío API key o configuración alternativa
prompt STRING multiline No vacío text_to_model
negative_prompt STRING multiline No vacío —
image IMAGE No — image_to_model origen; multiview_to_model vista frontal
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 se trata como no definido
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; modos image/multiview
file_prefix STRING No vacío —
output_directory STRING No vacío —

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

Los tres modos tienen estas entradas condicionales:

mode Obligatorio según modo Nota
text_to_model prompt prompt no puede estar vacío.
image_to_model image Se requiere image.
multiview_to_model image image 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
apikey STRING Sí vacío API key o configuración alternativa
model_file file selector No none directorio input de ComfyUI
model_url STRING No vacío URL directa
file_prefix STRING No vacío se propaga
output_directory STRING No vacío se propaga

Salida: MODEL_INFO. 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 → TripoImportModel → MODEL_INFO.

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

Procesamiento del modelo

TripoTextureModel — Tripo: Texture model

Aplica texturas a un modelo.

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

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

TripoRefineModel — Tripo: Refine Draft model

Refina un borrador compatible.

Entrada Tipo Obligatorio Predeterminado Valores / rango
model_info MODEL_INFO Sí — contexto de borrador

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

TripoMeshSegmentation — Tripo: Segment mesh

Segmenta una malla.

Entrada Tipo Obligatorio Predeterminado Valores / rango
model_info MODEL_INFO Sí — contexto de tarea anterior
model_version ENUM Sí v1.0-20250506 v1.0-20250506, v2.0-20260430
segmentation_granularity ENUM No balanced simple, balanced, detailed; solo v2
ref_image IMAGE No — solo v2
split_by_connectivity BOOLEAN No true solo v2

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

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

TripoMeshCompletion — Tripo: Complete mesh

Completa una malla segmentada.

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

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

TripoSmartLowPoly — Tripo: Smart low poly

Crea un modelo low-poly.

Entrada Tipo Obligatorio Predeterminado Valores / rango
model_info MODEL_INFO Sí — contexto de tarea anterior
model_version ENUM Sí P-v2.0-20251225 P-v2.0-20251225
quad BOOLEAN No false —
part_names STRING multiline No vacío one name per line
face_limit INT No 10000 -1–20000
bake BOOLEAN No true —

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

TripoStylizeModel — Tripo: Stylize model

Aplica un estilo geométrico.

Entrada Tipo Obligatorio Predeterminado Valores / rango
model_info MODEL_INFO Sí — contexto de tarea anterior
style ENUM Sí primer valor lego, voxel, voronoi, minecraft
block_size INT Sí 80 1–1000

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

Rigging y animación

TripoAnimateRigNode — Tripo: Rig model

Hace rigging automático.

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

Salida: STRING model_file + MODEL_INFO. Requisito previo: Generate / Import MODEL_INFO. Fallos habituales: modelo no apto, sin rig type o fallo de API. Conexión mínima: Generate / Import → TripoAnimateRigNode → 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
model_info MODEL_INFO Sí — contexto con rig
animation ENUM Sí primer valor 16 presets siguientes
out_format ENUM Sí glb glb, fbx
bake_animation BOOLEAN No true —
export_with_geometry BOOLEAN No false —

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

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

Salida de formato

TripoConvertNode — Tripo: Convert model

Convierte y exporta un modelo.

Entrada Tipo Obligatorio Predeterminado Valores / rango
model_info MODEL_INFO Sí — contexto de tarea anterior
format ENUM Sí primer valor 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 minimum 0
with_animation BOOLEAN No true —
pack_uv BOOLEAN No false —
bake BOOLEAN No true —
part_names STRING multiline No vacío one name per line
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 —

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

Convert es un nodo de salida y no devuelve MODEL_INFO.

Ejemplos de workflows

Preview 3D es solo un visor opcional de ComfyUI.

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

Genera un modelo desde texto y envía model_file a Preview 3D.

Descargar el PNG original del workflow

Image to Mesh

Workflow de imagen a malla con Load Image, Tripo Generate model y Preview 3D

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

Descargar el PNG original del workflow

Multiview Images to Mesh

Workflow multivista con tres nodos Load Image, Tripo Generate model y Preview 3D

Conecta las vistas frontal y laterales opcionales a Generate model en modo multiview_to_model.

Descargar el PNG original del workflow

Texture a generated model

Workflow de textura con Generate model, Texture model y vistas Preview 3D

Pasa MODEL_INFO de Generate model a Texture model y previsualiza ambas salidas.

Descargar el PNG original del workflow

Refine a draft Mesh

Workflow de refinado con Generate model, Refine Draft model y Preview 3D

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

Descargar el PNG original del workflow

Animation / Rig and export

Workflow de rig y exportación con Generate model, Rig model, Preview 3D y Convert model

Descargar el PNG original del workflow

Salida y solución de problemas

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

Síntoma Comprobación
Falta API Key Configura la clave del nodo, TRIPO_API_KEY o config.json.
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 error_code, error_msg, acceso y saldo.
No se puede mover la salida Revisa ruta y permisos de escritura.
No aparecen nodos Reinicia ComfyUI y revisa directorio y requirements.txt.
Falla la carga Revisa extensión y respuesta de carga de ComfyUI.