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

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

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