# ComfyUI-Nodes

ComfyUI-Tripo ist die offizielle Custom-Node-Erweiterung von Tripo für ComfyUI. Sie integriert die 3D-Generierung aus Text, Bildern und Mehrfachansichten in ComfyUI-Workflows und unterstützt außerdem Modellimport, Texturierung, Verfeinerung, Mesh-Verarbeitung, Low-Poly-Optimierung, Stilisierung, Rigging, Animation-Retargeting, Formatkonvertierung und Retopologie.

| Element | Wert |
| --- | --- |
| Node-Projektversion | <code>1.3.0</code> |
| Quell-Tag | <code>v1.3.1.1</code> |
| Repository | [VAST-AI-Research/ComfyUI-Tripo](https://github.com/VAST-AI-Research/ComfyUI-Tripo) |

## Funktionen und Änderungsprotokoll

### Funktionen

- 3D-Modelle aus Texteingaben erzeugen.
- 3D-Modelle aus Bildern erzeugen.
- Modelle über <code>model_url</code> von einer URL importieren.
- Unterstützt die Trennung von Modellteilen.
- 3D-Modelle riggen und animieren.
- Formate konvertieren und Modelle retopologisieren.

### Änderungsprotokoll

- 2026-06-30: Mesh Segmentation v2.0 zur Aufteilung von Modellen sowie direkter URL-Import über <code>model_url</code> hinzugefügt.
- 2026-05-28: Modellimport hinzugefügt.
- 2025-06-19: auf die neueste API aktualisiert und weitere Nodes hinzugefügt.
- 2025-03-31: auf das Paket <code>tripo3d</code> umgestellt.
- 2025-02-24: <code>glbviewer</code> entfernt.
- 2025-02-01: an die neue API angepasst und Preview 3D zur Modellansicht eingeführt.
- 2024-11-11: an die neue API angepasst.
- 2024-10-14: Modellkonvertierung hinzugefügt.
- 2024-09-13: <code>model_version</code> <code>v2.0-20240919</code> unterstützt.

## Installation

Offizielle Werkzeuge: [ComfyUI-Manager](https://github.com/ltdrdata/ComfyUI-Manager), [Comfy Registry](https://registry.comfy.org/) und [comfy-cli](https://github.com/Comfy-Org/comfy-cli).

**Wählen Sie eine Methode** und starten Sie ComfyUI danach neu.

1. **ComfyUI-Manager:** Im Custom Nodes Manager nach <code>Tripo for ComfyUI</code> suchen und installieren.
2. **comfy-cli:**

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

3. **Aus dem Quellcode:**

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

## API-Key-Konfiguration

Erstellen Sie zuerst auf der [Tripo-Plattform](https://platform.tripo3d.ai/) einen API-Key und konfigurieren Sie ihn dann mit einer der folgenden Methoden.

Der API-Key wird in dieser Reihenfolge aufgelöst:

1. Nicht leeres <code>apikey</code>-Eingabefeld im Node.
2. Umgebungsvariable <code>TRIPO_API_KEY</code>.
3. Feld <code>TRIPO_API_KEY</code> in <code>config.json</code> im Projektverzeichnis.

Generate und Import stellen <code>apikey</code> bereit; nachgelagerte Nodes erhalten den aufgelösten Key über <code>MODEL_INFO</code>. Echte Keys niemals in Screenshots, Workflows, Logs oder Repositories veröffentlichen.

### Startbeispiele mit Umgebungsvariable

Windows:

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

Linux oder macOS:

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

## Node-Übersicht

ComfyUI-Tripo stellt die folgenden 11 Tripo-Nodes bereit:

| Internal ID | Display name | Funktion | Ausgabe |
| --- | --- | --- | --- |
| <code>TripoAPIDraft</code> | Tripo: Generate model | Erzeugt Modelle aus Text, Bild oder mehreren Ansichten. | STRING <code>model_file</code> + <code>MODEL_INFO</code> |
| <code>TripoImportModel</code> | Tripo: Import model | Importiert ein lokales Modell oder eine Modell-URL. | <code>MODEL_INFO</code> |
| <code>TripoTextureModel</code> | Tripo: Texture model | Erzeugt Texturen für ein Modell. | STRING <code>model_file</code> + <code>MODEL_INFO</code> |
| <code>TripoRefineModel</code> | Tripo: Refine Draft model | Verfeinert einen kompatiblen Entwurf. | STRING <code>model_file</code> + <code>MODEL_INFO</code> |
| <code>TripoMeshSegmentation</code> | Tripo: Segment mesh | Segmentiert ein Mesh. | STRING <code>model_file</code> + <code>MODEL_INFO</code> |
| <code>TripoMeshCompletion</code> | Tripo: Complete mesh | Vervollständigt ein segmentiertes Mesh. | STRING <code>model_file</code> + <code>MODEL_INFO</code> |
| <code>TripoSmartLowPoly</code> | Tripo: Smart low poly | Erzeugt ein Low-Poly-Modell. | STRING <code>model_file</code> + <code>MODEL_INFO</code> |
| <code>TripoStylizeModel</code> | Tripo: Stylize model | Wendet einen geometrischen Stil an. | STRING <code>model_file</code> + <code>MODEL_INFO</code> |
| <code>TripoAnimateRigNode</code> | Tripo: Rig model | Riggt ein Modell automatisch. | STRING <code>model_file</code> + <code>MODEL_INFO</code> |
| <code>TripoAnimateRetargetNode</code> | Tripo: Retarget rigged model | Wendet eine Animationsvorgabe an. | STRING <code>model_file</code> + <code>MODEL_INFO</code> |
| <code>TripoConvertNode</code> | Tripo: Convert model | Konvertiert und exportiert ein Modell. | STRING <code>model_file</code> |

Preview 3D stammt aus ComfyUI und zählt nicht zu den 11 Tripo-Nodes.

## Verbindungen und Datenfluss

~~~mermaid
flowchart LR
    G["Generate model"] -->|MODEL_INFO| P["Modellverarbeitung"]
    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> ist der Pfad zur heruntergeladenen Datei für Vorschau oder Dateiverarbeitung.
- <code>MODEL_INFO</code> enthält <code>task_id</code>, den aufgelösten <code>apikey</code>, <code>file_prefix</code> und <code>output_directory</code>.
- Externe Modelle müssen zuerst durch <code>TripoImportModel</code>; ein Dateipfad ersetzt kein <code>MODEL_INFO</code>.
- Für weitere Tripo-Verarbeitung <code>MODEL_INFO</code> verbinden.

## Vollständige Node-Referenz

„Erforderlich“ kennzeichnet Eingaben, die laut Node-Definition erforderlich sind. Ein leeres <code>apikey</code> kann auf Umgebung oder Konfiguration zurückfallen. Ein Gedankenstrich bedeutet, dass kein expliziter Standardwert festgelegt ist.

### Erzeugung und Import

### TripoAPIDraft — Tripo: Generate model

Erzeugt Modelle aus Text, Bild oder mehreren Ansichten.

| Eingabe | Typ | Erforderlich | Standard | Werte / Bereich |
| --- | --- | --- | --- | --- |
| <code>mode</code> | ENUM | Ja | erster Wert | <code>text_to_model</code>, <code>image_to_model</code>, <code>multiview_to_model</code> |
| <code>apikey</code> | STRING | Ja | leer | API Key oder Rückfallkonfiguration |
| <code>prompt</code> | STRING multiline | Nein | leer | <code>text_to_model</code> |
| <code>negative_prompt</code> | STRING multiline | Nein | leer | — |
| <code>image</code> | IMAGE | Nein | — | <code>image_to_model</code> Quelle; <code>multiview_to_model</code> Vorderansicht |
| <code>image_left</code> | IMAGE | Nein | — | <code>multiview_to_model</code> |
| <code>image_back</code> | IMAGE | Nein | — | <code>multiview_to_model</code> |
| <code>image_right</code> | IMAGE | Nein | — | <code>multiview_to_model</code> |
| <code>model_version</code> | ENUM | Nein | <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 | Nein | <code>true</code> | — |
| <code>pbr</code> | BOOLEAN | Nein | <code>true</code> | — |
| <code>image_seed</code> | INT | Nein | <code>42</code> | <code>text_to_model</code> |
| <code>model_seed</code> | INT | Nein | <code>42</code> | — |
| <code>texture_seed</code> | INT | Nein | <code>42</code> | — |
| <code>texture_quality</code> | ENUM | Nein | <code>standard</code> | <code>standard</code>, <code>detailed</code> |
| <code>geometry_quality</code> | ENUM | Nein | <code>standard</code> | <code>standard</code>, <code>detailed</code>; <code>image_to_model</code> |
| <code>texture_alignment</code> | ENUM | Nein | <code>original_image</code> | <code>original_image</code>, <code>geometry</code> |
| <code>face_limit</code> | INT | Nein | <code>-1</code> | <code>-1</code>–<code>500000</code>; ≤ 0 gilt als nicht gesetzt |
| <code>quad</code> | BOOLEAN | Nein | <code>false</code> | — |
| <code>compress</code> | BOOLEAN | Nein | <code>false</code> | — |
| <code>generate_parts</code> | BOOLEAN | Nein | <code>false</code> | — |
| <code>smart_low_poly</code> | BOOLEAN | Nein | <code>false</code> | — |
| <code>auto_size</code> | BOOLEAN | Nein | <code>false</code> | — |
| <code>orientation</code> | ENUM | Nein | <code>default</code> | <code>default</code>, <code>align_image</code>; Bild-/Multiview-Modi |
| <code>file_prefix</code> | STRING | Nein | leer | — |
| <code>output_directory</code> | STRING | Nein | leer | — |

**Ausgabe:** STRING <code>model_file</code> + <code>MODEL_INFO</code>. **Voraussetzung:** keine. **Typische Fehler:** Bedingte Eingabe, Key, API-Task oder Verschieben der Ausgabe fehlerhaft. **Minimalverbindung:** Text/Bild → <code>TripoAPIDraft</code> → Preview 3D.

Die drei Modi haben folgende bedingte Pflichtfelder:

| <code>mode</code> | Bedingt erforderlich | Hinweis |
| --- | --- | --- |
| <code>text_to_model</code> | <code>prompt</code> | <code>prompt</code> darf nicht leer sein. |
| <code>image_to_model</code> | <code>image</code> | <code>image</code> ist erforderlich. |
| <code>multiview_to_model</code> | <code>image</code> | <code>image</code> ist die Vorderansicht; links, hinten und rechts sind optional. |

### TripoImportModel — Tripo: Import model

Importiert ein lokales Modell oder eine Modell-URL.

| Eingabe | Typ | Erforderlich | Standard | Werte / Bereich |
| --- | --- | --- | --- | --- |
| <code>apikey</code> | STRING | Ja | leer | API Key oder Rückfallkonfiguration |
| <code>model_file</code> | file selector | Nein | <code>none</code> | ComfyUI-Eingabeverzeichnis |
| <code>model_url</code> | STRING | Nein | leer | direkte URL |
| <code>file_prefix</code> | STRING | Nein | leer | wird weitergegeben |
| <code>output_directory</code> | STRING | Nein | leer | wird weitergegeben |

**Ausgabe:** <code>MODEL_INFO</code>. **Voraussetzung:** lokale Datei oder URL. **Typische Fehler:** Quelle fehlt/ist nicht erreichbar, Format abgelehnt oder Import fehlgeschlagen. **Minimalverbindung:** lokale Datei oder URL → <code>TripoImportModel</code> → MODEL_INFO.

Ein nicht leeres <code>model_url</code> hat Vorrang vor <code>model_file</code>. Ohne beide Eingaben schlägt der Node fehl. Der Upload akzeptiert <code>.glb</code>, <code>.fbx</code>, <code>.obj</code>, <code>.stl</code>, <code>.ply</code>, <code>.3mf</code> und <code>.gltf</code>; der Backend-Scan erkennt außerdem <code>.zip</code>.

### Modellverarbeitung

### TripoTextureModel — Tripo: Texture model

Erzeugt Texturen für ein Modell.

| Eingabe | Typ | Erforderlich | Standard | Werte / Bereich |
| --- | --- | --- | --- | --- |
| <code>model_info</code> | MODEL_INFO | Ja | — | vorgelagerter Task-Kontext |
| <code>model_version</code> | ENUM | Nein | <code>v3.0-20250812</code> | <code>v2.5-20250123</code>, <code>v3.0-20250812</code> |
| <code>texture</code> | BOOLEAN | Nein | <code>true</code> | — |
| <code>pbr</code> | BOOLEAN | Nein | <code>true</code> | — |
| <code>texture_seed</code> | INT | Nein | <code>42</code> | — |
| <code>texture_quality</code> | ENUM | Nein | <code>standard</code> | <code>standard</code>, <code>detailed</code> |
| <code>texture_alignment</code> | ENUM | Nein | <code>original_image</code> | <code>original_image</code>, <code>geometry</code> |
| <code>text_prompt</code> | STRING multiline | Nein | leer | — |
| <code>image_prompt</code> | IMAGE | Nein | — | — |
| <code>style_image</code> | IMAGE | Nein | — | — |
| <code>part_names</code> | STRING multiline | Nein | leer | one name per line |
| <code>compress</code> | BOOLEAN | Nein | <code>false</code> | — |
| <code>bake</code> | BOOLEAN | Nein | <code>true</code> | — |

**Ausgabe:** STRING <code>model_file</code> + <code>MODEL_INFO</code>. **Voraussetzung:** Generate / Import MODEL_INFO. **Typische Fehler:** inkompatibler Kontext, ungültiges Referenzbild oder API-Fehler. **Minimalverbindung:** Generate / Import → <code>TripoTextureModel</code> → Preview 3D.

### TripoRefineModel — Tripo: Refine Draft model

Verfeinert einen kompatiblen Entwurf.

| Eingabe | Typ | Erforderlich | Standard | Werte / Bereich |
| --- | --- | --- | --- | --- |
| <code>model_info</code> | MODEL_INFO | Ja | — | Entwurfs-Task-Kontext |

**Ausgabe:** STRING <code>model_file</code> + <code>MODEL_INFO</code>. **Voraussetzung:** verfeinerbarer Entwurf als MODEL_INFO. **Typische Fehler:** kein verfeinerbarer Entwurf oder API-Fehler. **Minimalverbindung:** Generate draft → <code>TripoRefineModel</code> → Preview 3D.

### TripoMeshSegmentation — Tripo: Segment mesh

Segmentiert ein Mesh.

| Eingabe | Typ | Erforderlich | Standard | Werte / Bereich |
| --- | --- | --- | --- | --- |
| <code>model_info</code> | MODEL_INFO | Ja | — | vorgelagerter Task-Kontext |
| <code>model_version</code> | ENUM | Ja | <code>v1.0-20250506</code> | <code>v1.0-20250506</code>, <code>v2.0-20260430</code> |
| <code>segmentation_granularity</code> | ENUM | Nein | <code>balanced</code> | <code>simple</code>, <code>balanced</code>, <code>detailed</code>; nur v2 |
| <code>ref_image</code> | IMAGE | Nein | — | nur v2 |
| <code>split_by_connectivity</code> | BOOLEAN | Nein | <code>true</code> | nur v2 |

**Ausgabe:** STRING <code>model_file</code> + <code>MODEL_INFO</code>. **Voraussetzung:** Generate / Import MODEL_INFO. **Typische Fehler:** inkompatibles Modell/Referenzbild oder API-Fehler. **Minimalverbindung:** Generate / Import → <code>TripoMeshSegmentation</code> → Completion / Preview.

<code>segmentation_granularity</code>, <code>ref_image</code> und <code>split_by_connectivity</code> werden nur bei <code>v2.0-20260430</code> gesendet; v1 ignoriert sie.

### TripoMeshCompletion — Tripo: Complete mesh

Vervollständigt ein segmentiertes Mesh.

| Eingabe | Typ | Erforderlich | Standard | Werte / Bereich |
| --- | --- | --- | --- | --- |
| <code>model_info</code> | MODEL_INFO | Ja | — | segmentierter Task-Kontext |
| <code>model_version</code> | ENUM | Ja | <code>v1.0-20250506</code> | <code>v1.0-20250506</code> |
| <code>part_names</code> | STRING multiline | Nein | leer | one name per line |

**Ausgabe:** STRING <code>model_file</code> + <code>MODEL_INFO</code>. **Voraussetzung:** segmentiertes MODEL_INFO. **Typische Fehler:** ungeeigneter Segmentierungs-Task oder API-Fehler. **Minimalverbindung:** Segment → <code>TripoMeshCompletion</code> → Preview 3D.

### TripoSmartLowPoly — Tripo: Smart low poly

Erzeugt ein Low-Poly-Modell.

| Eingabe | Typ | Erforderlich | Standard | Werte / Bereich |
| --- | --- | --- | --- | --- |
| <code>model_info</code> | MODEL_INFO | Ja | — | vorgelagerter Task-Kontext |
| <code>model_version</code> | ENUM | Ja | <code>P-v2.0-20251225</code> | <code>P-v2.0-20251225</code> |
| <code>quad</code> | BOOLEAN | Nein | <code>false</code> | — |
| <code>part_names</code> | STRING multiline | Nein | leer | one name per line |
| <code>face_limit</code> | INT | Nein | <code>10000</code> | <code>-1</code>–<code>20000</code> |
| <code>bake</code> | BOOLEAN | Nein | <code>true</code> | — |

**Ausgabe:** STRING <code>model_file</code> + <code>MODEL_INFO</code>. **Voraussetzung:** Generate / Import MODEL_INFO. **Typische Fehler:** inkompatibles Modell/Teile oder API-Fehler. **Minimalverbindung:** Generate / Import → <code>TripoSmartLowPoly</code> → Preview / Convert.

### TripoStylizeModel — Tripo: Stylize model

Wendet einen geometrischen Stil an.

| Eingabe | Typ | Erforderlich | Standard | Werte / Bereich |
| --- | --- | --- | --- | --- |
| <code>model_info</code> | MODEL_INFO | Ja | — | vorgelagerter Task-Kontext |
| <code>style</code> | ENUM | Ja | erster Wert | <code>lego</code>, <code>voxel</code>, <code>voronoi</code>, <code>minecraft</code> |
| <code>block_size</code> | INT | Ja | <code>80</code> | <code>1</code>–<code>1000</code> |

**Ausgabe:** STRING <code>model_file</code> + <code>MODEL_INFO</code>. **Voraussetzung:** Generate / Import MODEL_INFO. **Typische Fehler:** inkompatibles Modell/Stil oder API-Fehler. **Minimalverbindung:** Generate / Import → <code>TripoStylizeModel</code> → Preview 3D.

### Rigging und Animation

### TripoAnimateRigNode — Tripo: Rig model

Riggt ein Modell automatisch.

| Eingabe | Typ | Erforderlich | Standard | Werte / Bereich |
| --- | --- | --- | --- | --- |
| <code>model_info</code> | MODEL_INFO | Ja | — | vorgelagerter Task-Kontext |
| <code>model_version</code> | ENUM | Ja | <code>v2.0-20250506</code> | <code>v1.0-20240301</code>, <code>v2.0-20250506</code> |
| <code>out_format</code> | ENUM | Ja | <code>glb</code> | <code>glb</code>, <code>fbx</code> |
| <code>spec</code> | ENUM | Ja | <code>tripo</code> | <code>mixamo</code>, <code>tripo</code> |

**Ausgabe:** STRING <code>model_file</code> + <code>MODEL_INFO</code>. **Voraussetzung:** Generate / Import MODEL_INFO. **Typische Fehler:** Modell nicht riggbar, kein rig type oder API-Fehler. **Minimalverbindung:** Generate / Import → <code>TripoAnimateRigNode</code> → Retarget / Preview.

Vor dem Rigging prüft der Node die Eignung und ermittelt einen rig type.

### TripoAnimateRetargetNode — Tripo: Retarget rigged model

Wendet eine Animationsvorgabe an.

| Eingabe | Typ | Erforderlich | Standard | Werte / Bereich |
| --- | --- | --- | --- | --- |
| <code>model_info</code> | MODEL_INFO | Ja | — | geriggter Task-Kontext |
| <code>animation</code> | ENUM | Ja | erster Wert | 16 Vorgaben unten |
| <code>out_format</code> | ENUM | Ja | <code>glb</code> | <code>glb</code>, <code>fbx</code> |
| <code>bake_animation</code> | BOOLEAN | Nein | <code>true</code> | — |
| <code>export_with_geometry</code> | BOOLEAN | Nein | <code>false</code> | — |

**Ausgabe:** STRING <code>model_file</code> + <code>MODEL_INFO</code>. **Voraussetzung:** geriggtes MODEL_INFO. **Typische Fehler:** nicht geriggter Kontext oder API-Fehler. **Minimalverbindung:** Rig → <code>TripoAnimateRetargetNode</code> → Preview / Convert.

Die 16 Animationswerte sind: <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>.

### Formatausgabe

### TripoConvertNode — Tripo: Convert model

Konvertiert und exportiert ein Modell.

| Eingabe | Typ | Erforderlich | Standard | Werte / Bereich |
| --- | --- | --- | --- | --- |
| <code>model_info</code> | MODEL_INFO | Ja | — | vorgelagerter Task-Kontext |
| <code>format</code> | ENUM | Ja | erster Wert | <code>GLTF</code>, <code>USDZ</code>, <code>FBX</code>, <code>OBJ</code>, <code>STL</code>, <code>3MF</code> |
| <code>quad</code> | BOOLEAN | Nein | <code>false</code> | — |
| <code>force_symmetry</code> | BOOLEAN | Nein | <code>false</code> | — |
| <code>face_limit</code> | INT | Nein | <code>-1</code> | <code>-1</code>–<code>500000</code> |
| <code>flatten_bottom</code> | BOOLEAN | Nein | <code>false</code> | — |
| <code>flatten_bottom_threshold</code> | FLOAT | Nein | <code>0.01</code> | <code>0.0</code>–<code>1.0</code> |
| <code>texture_size</code> | INT | Nein | <code>4096</code> | <code>128</code>–<code>4096</code> |
| <code>texture_format</code> | ENUM | Nein | <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 | Nein | <code>false</code> | — |
| <code>scale_factor</code> | FLOAT | Nein | <code>1.0</code> | minimum <code>0</code> |
| <code>with_animation</code> | BOOLEAN | Nein | <code>true</code> | — |
| <code>pack_uv</code> | BOOLEAN | Nein | <code>false</code> | — |
| <code>bake</code> | BOOLEAN | Nein | <code>true</code> | — |
| <code>part_names</code> | STRING multiline | Nein | leer | one name per line |
| <code>fbx_preset</code> | ENUM | Nein | <code>blender</code> | <code>blender</code>, <code>mixamo</code>, <code>3dsmax</code> |
| <code>export_vertex_colors</code> | BOOLEAN | Nein | <code>false</code> | — |
| <code>export_orientation</code> | ENUM | Nein | <code>+x</code> | <code>+x</code>, <code>+y</code>, <code>-x</code>, <code>-y</code> |
| <code>animate_in_place</code> | BOOLEAN | Nein | <code>false</code> | — |

**Ausgabe:** STRING <code>model_file</code>. **Voraussetzung:** kompatibles MODEL_INFO. **Typische Fehler:** nicht unterstützte Konvertierung, ungültige Einstellungen oder Ausgabefehler. **Minimalverbindung:** MODEL_INFO → <code>TripoConvertNode</code>.

Convert ist ein Ausgabe-Node und liefert kein <code>MODEL_INFO</code>.

## Workflow-Beispiele

Preview 3D ist nur ein optionaler ComfyUI-Viewer.

~~~mermaid
flowchart LR
    T["Text"] --> GT["Generate model<br/>mode: text_to_model"]
    IM["Bild"] --> GI["Generate model<br/>mode: image_to_model"]
    MV["Vorderansicht + optionale Ansichten"] --> GM["Generate model<br/>mode: multiview_to_model"]
    GT --> V["Preview 3D"]
    GI --> V
    GM --> V
~~~

1. **Text to Model:** <code>prompt</code> → Generate mit <code>text_to_model</code> → Preview 3D.
2. **Image to Model:** IMAGE → <code>image</code>, Modus <code>image_to_model</code> → Preview 3D.
3. **Multiview to Model:** Vorderansicht an <code>image</code>, optionale Ansichten an <code>image_left</code>, <code>image_back</code>, <code>image_right</code>.
4. **Texture Model:** Generate/Import → MODEL_INFO → Texture → Preview.
5. **Refine Model:** kompatibler Entwurf → MODEL_INFO → Refine → Preview.
6. **Rig and Retarget:** Generate/Import → Rig → Retarget; jeweils MODEL_INFO verbinden.
7. **Import and Process:** Datei/URL → Import → Segment/Smart low poly/Stylize/Texture.
8. **Convert and Export:** finales MODEL_INFO → Convert → Ausgabeformat wählen.

### Offizielle Workflow-PNGs

Die folgenden sechs PNG-Dateien enthalten eingebettete ComfyUI-Workflow-Daten. Speichern Sie die Originaldatei über den Download-Link und ziehen Sie sie in ComfyUI oder laden Sie sie manuell. Die in den Bildern gezeigten Parameterwerte sind nur Beispiele; die aktuellen Standardwerte stehen in den Parametertabellen.

#### Text to Mesh

![ComfyUI-Text-zu-Mesh-Workflow mit Tripo Generate model und Preview 3D](/assets/images/docs/comfyui-nodes/text_to_model.png)

Erzeugt ein Modell aus Text und sendet <code>model_file</code> an Preview 3D.

<a href="/assets/images/docs/comfyui-nodes/text_to_model.png" download>Original-Workflow-PNG herunterladen</a>

#### Image to Mesh

![ComfyUI-Bild-zu-Mesh-Workflow mit Load Image, Tripo Generate model und Preview 3D](/assets/images/docs/comfyui-nodes/image_to_model.png)

Lädt ein Bild, verbindet es im Modus <code>image_to_model</code> mit Generate model und zeigt das Ergebnis an.

<a href="/assets/images/docs/comfyui-nodes/image_to_model.png" download>Original-Workflow-PNG herunterladen</a>

#### Multiview Images to Mesh

![ComfyUI-Multiview-Workflow mit drei Load-Image-Nodes, Tripo Generate model und Preview 3D](/assets/images/docs/comfyui-nodes/multiview_to_model.png)

Verbindet Vorder- und optionale Seitenansichten im Modus <code>multiview_to_model</code> mit Generate model.

<a href="/assets/images/docs/comfyui-nodes/multiview_to_model.png" download>Original-Workflow-PNG herunterladen</a>

#### Texture a generated model

![ComfyUI-Textur-Workflow mit Generate model, Texture model und zwei Preview-3D-Nodes](/assets/images/docs/comfyui-nodes/texture_model.png)

Übergibt <code>MODEL_INFO</code> von Generate model an Texture model und zeigt beide Ausgaben an.

<a href="/assets/images/docs/comfyui-nodes/texture_model.png" download>Original-Workflow-PNG herunterladen</a>

#### Refine a draft Mesh

![ComfyUI-Refine-Workflow mit Generate model, Refine Draft model und Preview 3D](/assets/images/docs/comfyui-nodes/refine_model.png)

Erzeugt einen kompatiblen Entwurf, übergibt <code>MODEL_INFO</code> an Refine Draft model und zeigt das Ergebnis an.

<a href="/assets/images/docs/comfyui-nodes/refine_model.png" download>Original-Workflow-PNG herunterladen</a>

#### Animation / Rig and export

![ComfyUI-Rig-und-Export-Workflow mit Generate model, Rig model, Preview 3D und Convert model](/assets/images/docs/comfyui-nodes/retarget.png)

<a href="/assets/images/docs/comfyui-nodes/retarget.png" download>Original-Workflow-PNG herunterladen</a>

## Ausgabe und Fehlerbehebung

Downloads landen standardmäßig in <code>ComfyUI/output</code>. <code>file_prefix</code> benennt die Datei, <code>output_directory</code> verschiebt sie; beide Werte werden in <code>MODEL_INFO</code> weitergereicht.

| Symptom | Prüfung |
| --- | --- |
| API-Key fehlt | Node-Key, <code>TRIPO_API_KEY</code> oder <code>config.json</code> setzen. |
| Prompt/Vorderansicht fehlt | Modus und bedingt erforderliche Eingabe abgleichen. |
| Import startet nicht | Erreichbare URL oder vorhandene Datei angeben; URL hat Vorrang. |
| Modell nicht riggbar | Geeignetes Charaktermodell verwenden. |
| API-Task fehlgeschlagen | <code>error_code</code>, <code>error_msg</code>, Zugriff und Guthaben prüfen. |
| Ausgabe kann nicht verschoben werden | Zielpfad und Schreibrechte prüfen. |
| Nodes fehlen | ComfyUI neu starten, Verzeichnis und <code>requirements.txt</code> prüfen. |
| Upload schlägt fehl | Dateiendung und ComfyUI-Uploadantwort prüfen. |