# ComfyUI Düğümleri

ComfyUI-Tripo, Tripo'nun ComfyUI için resmi özel düğüm eklentisidir. Metin, görüntü veya çoklu görünümden 3D üretimini ComfyUI iş akışlarına taşır; ayrıca model içe aktarma, dokulama, iyileştirme, ağ işleme, düşük poligon optimizasyonu, stilizasyon, rigleme, animasyon yeniden hedefleme, biçim dönüştürme ve retopolojiyi destekler.

| Öğe | Değer |
| --- | --- |
| Node proje sürümü | <code>1.3.0</code> |
| Kaynak etiketi | <code>v1.3.1.1</code> |
| Depo | [VAST-AI-Research/ComfyUI-Tripo](https://github.com/VAST-AI-Research/ComfyUI-Tripo) |

## Özellikler ve değişiklik günlüğü

### Özellikler

- Metinden 3B model oluşturma.
- Görüntülerden 3B model oluşturma.
- <code>model_url</code> ile URL’den model içe aktarma.
- Model parçalarını ayırmayı destekler.
- 3B modelleri rigleme ve animasyon uygulama.
- Format dönüştürme ve retopoloji.

### Değişiklik günlüğü

- 2026-06-30: modelleri parçalara ayırmak için Mesh Segmentation v2.0 ve <code>model_url</code> ile doğrudan URL içe aktarma eklendi.
- 2026-05-28: model içe aktarma eklendi.
- 2025-06-19: en yeni API’ye geçildi ve yeni düğümler eklendi.
- 2025-03-31: <code>tripo3d</code> paketine geçildi.
- 2025-02-24: <code>glbviewer</code> kaldırıldı.
- 2025-02-01: yeni API’ye uyum sağlandı ve model görüntüleme Preview 3D’ye taşındı.
- 2024-11-11: yeni API’ye uyum sağlandı.
- 2024-10-14: model dönüştürme eklendi.
- 2024-09-13: <code>model_version</code> <code>v2.0-20240919</code> desteği eklendi.

## Kurulum

Resmî araçlar: [ComfyUI-Manager](https://github.com/ltdrdata/ComfyUI-Manager), [Comfy Registry](https://registry.comfy.org/) ve [comfy-cli](https://github.com/Comfy-Org/comfy-cli).

**Bir yöntem seçin** ve ardından ComfyUI’yi yeniden başlatın.

1. **ComfyUI-Manager:** Custom Nodes Manager içinde <code>Tripo for ComfyUI</code> arayıp kurun.
2. **comfy-cli:**

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

3. **Kaynaktan:**

~~~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 yapılandırması

Önce [Tripo platformunda](https://platform.tripo3d.ai/) bir API Key oluşturun, ardından aşağıdaki yöntemlerden biriyle yapılandırın.

Anahtar şu sırayla çözümlenir:

1. Düğümde boş olmayan <code>apikey</code> girdisi.
2. <code>TRIPO_API_KEY</code> ortam değişkeni.
3. Proje dizinindeki <code>config.json</code> dosyasının <code>TRIPO_API_KEY</code> alanı.

Generate ve Import <code>apikey</code> sunar; sonraki düğümler çözümlenen anahtarı <code>MODEL_INFO</code> ile alır. Gerçek anahtarı ekran görüntülerinde, workflow dosyalarında, loglarda veya depolarda paylaşmayın.

### Ortam değişkeniyle başlatma örnekleri

Windows:

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

Linux veya macOS:

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

## Düğüm özeti

ComfyUI-Tripo aşağıdaki 11 Tripo düğümünü sunar:

| Dahili ID | Arayüz adı | Yetenek | Çıktı |
| --- | --- | --- | --- |
| <code>TripoAPIDraft</code> | Tripo: Generate model | Metin, görsel veya çoklu görünümden model üretir. | STRING <code>model_file</code> + <code>MODEL_INFO</code> |
| <code>TripoImportModel</code> | Tripo: Import model | Yerel model veya URL içe aktarır. | <code>MODEL_INFO</code> |
| <code>TripoTextureModel</code> | Tripo: Texture model | Modele doku uygular. | STRING <code>model_file</code> + <code>MODEL_INFO</code> |
| <code>TripoRefineModel</code> | Tripo: Refine Draft model | Uyumlu taslağı iyileştirir. | STRING <code>model_file</code> + <code>MODEL_INFO</code> |
| <code>TripoMeshSegmentation</code> | Tripo: Segment mesh | Mesh segmentasyonu yapar. | STRING <code>model_file</code> + <code>MODEL_INFO</code> |
| <code>TripoMeshCompletion</code> | Tripo: Complete mesh | Segmentli mesh’i tamamlar. | STRING <code>model_file</code> + <code>MODEL_INFO</code> |
| <code>TripoSmartLowPoly</code> | Tripo: Smart low poly | Low-poly model oluşturur. | STRING <code>model_file</code> + <code>MODEL_INFO</code> |
| <code>TripoStylizeModel</code> | Tripo: Stylize model | Geometrik stil uygular. | STRING <code>model_file</code> + <code>MODEL_INFO</code> |
| <code>TripoAnimateRigNode</code> | Tripo: Rig model | Otomatik rig uygular. | STRING <code>model_file</code> + <code>MODEL_INFO</code> |
| <code>TripoAnimateRetargetNode</code> | Tripo: Retarget rigged model | Hazır animasyon uygular. | STRING <code>model_file</code> + <code>MODEL_INFO</code> |
| <code>TripoConvertNode</code> | Tripo: Convert model | Modeli dönüştürür ve dışa aktarır. | STRING <code>model_file</code> |

Preview 3D, ComfyUI tarafından sağlanır ve 11 Tripo düğümüne dahil değildir.

## Bağlantılar ve veri akışı

~~~mermaid
flowchart LR
    G["Generate model"] -->|MODEL_INFO| P["Model işleme"]
    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>, önizleme veya dosya işlemleri için indirilen dosya yoludur.
- <code>MODEL_INFO</code>, <code>task_id</code>, çözümlenen <code>apikey</code>, <code>file_prefix</code> ve <code>output_directory</code> içerir.
- Harici model önce <code>TripoImportModel</code> üzerinden geçmelidir; dosya yolu <code>MODEL_INFO</code> yerine geçmez.
- Tripo işlemine devam etmek için <code>MODEL_INFO</code> bağlayın.

## Tam düğüm referansı

“Zorunlu”, düğüm tanımında gerekli olan girişleri belirtir. Boş <code>apikey</code>, ortam veya yapılandırmaya dönebilir. Tire, açık bir varsayılan değer tanımlanmadığını gösterir.

### Üretim ve içe aktarma

### TripoAPIDraft — Tripo: Generate model

Metin, görsel veya çoklu görünümden model üretir.

| Girdi | Tür | Zorunlu | Varsayılan | Değerler / aralık |
| --- | --- | --- | --- | --- |
| <code>mode</code> | ENUM | Evet | ilk değer | <code>text_to_model</code>, <code>image_to_model</code>, <code>multiview_to_model</code> |
| <code>apikey</code> | STRING | Evet | boş | API key veya geri dönüş |
| <code>prompt</code> | STRING multiline | Hayır | boş | <code>text_to_model</code> |
| <code>negative_prompt</code> | STRING multiline | Hayır | boş | — |
| <code>image</code> | IMAGE | Hayır | — | <code>image_to_model</code> kaynak; <code>multiview_to_model</code> ön görünüm |
| <code>image_left</code> | IMAGE | Hayır | — | <code>multiview_to_model</code> |
| <code>image_back</code> | IMAGE | Hayır | — | <code>multiview_to_model</code> |
| <code>image_right</code> | IMAGE | Hayır | — | <code>multiview_to_model</code> |
| <code>model_version</code> | ENUM | Hayır | <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 | Hayır | <code>true</code> | — |
| <code>pbr</code> | BOOLEAN | Hayır | <code>true</code> | — |
| <code>image_seed</code> | INT | Hayır | <code>42</code> | <code>text_to_model</code> |
| <code>model_seed</code> | INT | Hayır | <code>42</code> | — |
| <code>texture_seed</code> | INT | Hayır | <code>42</code> | — |
| <code>texture_quality</code> | ENUM | Hayır | <code>standard</code> | <code>standard</code>, <code>detailed</code> |
| <code>geometry_quality</code> | ENUM | Hayır | <code>standard</code> | <code>standard</code>, <code>detailed</code>; <code>image_to_model</code> |
| <code>texture_alignment</code> | ENUM | Hayır | <code>original_image</code> | <code>original_image</code>, <code>geometry</code> |
| <code>face_limit</code> | INT | Hayır | <code>-1</code> | <code>-1</code>–<code>500000</code>; ≤ 0 ayarlanmamış sayılır |
| <code>quad</code> | BOOLEAN | Hayır | <code>false</code> | — |
| <code>compress</code> | BOOLEAN | Hayır | <code>false</code> | — |
| <code>generate_parts</code> | BOOLEAN | Hayır | <code>false</code> | — |
| <code>smart_low_poly</code> | BOOLEAN | Hayır | <code>false</code> | — |
| <code>auto_size</code> | BOOLEAN | Hayır | <code>false</code> | — |
| <code>orientation</code> | ENUM | Hayır | <code>default</code> | <code>default</code>, <code>align_image</code>; görsel/multiview modları |
| <code>file_prefix</code> | STRING | Hayır | boş | — |
| <code>output_directory</code> | STRING | Hayır | boş | — |

**Çıktı:** STRING <code>model_file</code> + <code>MODEL_INFO</code>. **Önkoşul:** yok. **Yaygın hatalar:** koşullu girdi/anahtar eksik, API görevi veya çıktı taşıma hatası. **En küçük bağlantı:** Metin/görsel → <code>TripoAPIDraft</code> → Preview 3D.

Üç modun koşullu zorunlu girdileri:

| <code>mode</code> | Moda göre zorunlu | Not |
| --- | --- | --- |
| <code>text_to_model</code> | <code>prompt</code> | <code>prompt</code> boş olamaz. |
| <code>image_to_model</code> | <code>image</code> | <code>image</code> zorunludur. |
| <code>multiview_to_model</code> | <code>image</code> | <code>image</code> ön görünümdür; sol, arka ve sağ isteğe bağlıdır. |

### TripoImportModel — Tripo: Import model

Yerel model veya URL içe aktarır.

| Girdi | Tür | Zorunlu | Varsayılan | Değerler / aralık |
| --- | --- | --- | --- | --- |
| <code>apikey</code> | STRING | Evet | boş | API key veya geri dönüş |
| <code>model_file</code> | file selector | Hayır | <code>none</code> | ComfyUI input dizini |
| <code>model_url</code> | STRING | Hayır | boş | doğrudan URL |
| <code>file_prefix</code> | STRING | Hayır | boş | aşağı aktarılır |
| <code>output_directory</code> | STRING | Hayır | boş | aşağı aktarılır |

**Çıktı:** <code>MODEL_INFO</code>. **Önkoşul:** yerel dosya veya URL. **Yaygın hatalar:** kaynak eksik/erişilemez, format reddedildi veya import hatası. **En küçük bağlantı:** yerel dosya veya URL → <code>TripoImportModel</code> → MODEL_INFO.

Boş olmayan <code>model_url</code>, <code>model_file</code> değerinden önceliklidir. İkisi de yoksa düğüm hata verir. Yükleme <code>.glb</code>, <code>.fbx</code>, <code>.obj</code>, <code>.stl</code>, <code>.ply</code>, <code>.3mf</code> ve <code>.gltf</code> kabul eder; backend ayrıca <code>.zip</code> tanır.

### Model işleme

### TripoTextureModel — Tripo: Texture model

Modele doku uygular.

| Girdi | Tür | Zorunlu | Varsayılan | Değerler / aralık |
| --- | --- | --- | --- | --- |
| <code>model_info</code> | MODEL_INFO | Evet | — | üst görev bağlamı |
| <code>model_version</code> | ENUM | Hayır | <code>v3.0-20250812</code> | <code>v2.5-20250123</code>, <code>v3.0-20250812</code> |
| <code>texture</code> | BOOLEAN | Hayır | <code>true</code> | — |
| <code>pbr</code> | BOOLEAN | Hayır | <code>true</code> | — |
| <code>texture_seed</code> | INT | Hayır | <code>42</code> | — |
| <code>texture_quality</code> | ENUM | Hayır | <code>standard</code> | <code>standard</code>, <code>detailed</code> |
| <code>texture_alignment</code> | ENUM | Hayır | <code>original_image</code> | <code>original_image</code>, <code>geometry</code> |
| <code>text_prompt</code> | STRING multiline | Hayır | boş | — |
| <code>image_prompt</code> | IMAGE | Hayır | — | — |
| <code>style_image</code> | IMAGE | Hayır | — | — |
| <code>part_names</code> | STRING multiline | Hayır | boş | satır başına bir ad |
| <code>compress</code> | BOOLEAN | Hayır | <code>false</code> | — |
| <code>bake</code> | BOOLEAN | Hayır | <code>true</code> | — |

**Çıktı:** STRING <code>model_file</code> + <code>MODEL_INFO</code>. **Önkoşul:** Generate / Import MODEL_INFO. **Yaygın hatalar:** uyumsuz bağlam, geçersiz görsel veya API hatası. **En küçük bağlantı:** Generate / Import → <code>TripoTextureModel</code> → Preview 3D.

### TripoRefineModel — Tripo: Refine Draft model

Uyumlu taslağı iyileştirir.

| Girdi | Tür | Zorunlu | Varsayılan | Değerler / aralık |
| --- | --- | --- | --- | --- |
| <code>model_info</code> | MODEL_INFO | Evet | — | taslak bağlamı |

**Çıktı:** STRING <code>model_file</code> + <code>MODEL_INFO</code>. **Önkoşul:** işlenebilir taslak MODEL_INFO. **Yaygın hatalar:** iyileştirilemeyen taslak veya API hatası. **En küçük bağlantı:** Generate draft → <code>TripoRefineModel</code> → Preview 3D.

### TripoMeshSegmentation — Tripo: Segment mesh

Mesh segmentasyonu yapar.

| Girdi | Tür | Zorunlu | Varsayılan | Değerler / aralık |
| --- | --- | --- | --- | --- |
| <code>model_info</code> | MODEL_INFO | Evet | — | üst görev bağlamı |
| <code>model_version</code> | ENUM | Evet | <code>v1.0-20250506</code> | <code>v1.0-20250506</code>, <code>v2.0-20260430</code> |
| <code>segmentation_granularity</code> | ENUM | Hayır | <code>balanced</code> | <code>simple</code>, <code>balanced</code>, <code>detailed</code>; v2 only |
| <code>ref_image</code> | IMAGE | Hayır | — | yalnızca v2 |
| <code>split_by_connectivity</code> | BOOLEAN | Hayır | <code>true</code> | yalnızca v2 |

**Çıktı:** STRING <code>model_file</code> + <code>MODEL_INFO</code>. **Önkoşul:** Generate / Import MODEL_INFO. **Yaygın hatalar:** uyumsuz model/referans veya API hatası. **En küçük bağlantı:** Generate / Import → <code>TripoMeshSegmentation</code> → Completion / Preview.

<code>segmentation_granularity</code>, <code>ref_image</code> ve <code>split_by_connectivity</code> yalnızca <code>v2.0-20260430</code> ile gönderilir; v1 bunları yok sayar.

### TripoMeshCompletion — Tripo: Complete mesh

Segmentli mesh’i tamamlar.

| Girdi | Tür | Zorunlu | Varsayılan | Değerler / aralık |
| --- | --- | --- | --- | --- |
| <code>model_info</code> | MODEL_INFO | Evet | — | segmentli bağlam |
| <code>model_version</code> | ENUM | Evet | <code>v1.0-20250506</code> | <code>v1.0-20250506</code> |
| <code>part_names</code> | STRING multiline | Hayır | boş | satır başına bir ad |

**Çıktı:** STRING <code>model_file</code> + <code>MODEL_INFO</code>. **Önkoşul:** segmentli MODEL_INFO. **Yaygın hatalar:** tamamlamaya uygun olmayan görev veya API hatası. **En küçük bağlantı:** Segment → <code>TripoMeshCompletion</code> → Preview 3D.

### TripoSmartLowPoly — Tripo: Smart low poly

Low-poly model oluşturur.

| Girdi | Tür | Zorunlu | Varsayılan | Değerler / aralık |
| --- | --- | --- | --- | --- |
| <code>model_info</code> | MODEL_INFO | Evet | — | üst görev bağlamı |
| <code>model_version</code> | ENUM | Evet | <code>P-v2.0-20251225</code> | <code>P-v2.0-20251225</code> |
| <code>quad</code> | BOOLEAN | Hayır | <code>false</code> | — |
| <code>part_names</code> | STRING multiline | Hayır | boş | satır başına bir ad |
| <code>face_limit</code> | INT | Hayır | <code>10000</code> | <code>-1</code>–<code>20000</code> |
| <code>bake</code> | BOOLEAN | Hayır | <code>true</code> | — |

**Çıktı:** STRING <code>model_file</code> + <code>MODEL_INFO</code>. **Önkoşul:** Generate / Import MODEL_INFO. **Yaygın hatalar:** uyumsuz model/parçalar veya API hatası. **En küçük bağlantı:** Generate / Import → <code>TripoSmartLowPoly</code> → Preview / Convert.

### TripoStylizeModel — Tripo: Stylize model

Geometrik stil uygular.

| Girdi | Tür | Zorunlu | Varsayılan | Değerler / aralık |
| --- | --- | --- | --- | --- |
| <code>model_info</code> | MODEL_INFO | Evet | — | üst görev bağlamı |
| <code>style</code> | ENUM | Evet | ilk değer | <code>lego</code>, <code>voxel</code>, <code>voronoi</code>, <code>minecraft</code> |
| <code>block_size</code> | INT | Evet | <code>80</code> | <code>1</code>–<code>1000</code> |

**Çıktı:** STRING <code>model_file</code> + <code>MODEL_INFO</code>. **Önkoşul:** Generate / Import MODEL_INFO. **Yaygın hatalar:** uyumsuz model/stil veya API hatası. **En küçük bağlantı:** Generate / Import → <code>TripoStylizeModel</code> → Preview 3D.

### Rig ve animasyon

### TripoAnimateRigNode — Tripo: Rig model

Otomatik rig uygular.

| Girdi | Tür | Zorunlu | Varsayılan | Değerler / aralık |
| --- | --- | --- | --- | --- |
| <code>model_info</code> | MODEL_INFO | Evet | — | üst görev bağlamı |
| <code>model_version</code> | ENUM | Evet | <code>v2.0-20250506</code> | <code>v1.0-20240301</code>, <code>v2.0-20250506</code> |
| <code>out_format</code> | ENUM | Evet | <code>glb</code> | <code>glb</code>, <code>fbx</code> |
| <code>spec</code> | ENUM | Evet | <code>tripo</code> | <code>mixamo</code>, <code>tripo</code> |

**Çıktı:** STRING <code>model_file</code> + <code>MODEL_INFO</code>. **Önkoşul:** Generate / Import MODEL_INFO. **Yaygın hatalar:** model rig için uygun değil, rig type yok veya API hatası. **En küçük bağlantı:** Generate / Import → <code>TripoAnimateRigNode</code> → Retarget / Preview.

Rig işleminden önce düğüm uygunluğu kontrol eder ve bir rig type alır.

### TripoAnimateRetargetNode — Tripo: Retarget rigged model

Hazır animasyon uygular.

| Girdi | Tür | Zorunlu | Varsayılan | Değerler / aralık |
| --- | --- | --- | --- | --- |
| <code>model_info</code> | MODEL_INFO | Evet | — | rig bağlamı |
| <code>animation</code> | ENUM | Evet | ilk değer | aşağıdaki 16 preset |
| <code>out_format</code> | ENUM | Evet | <code>glb</code> | <code>glb</code>, <code>fbx</code> |
| <code>bake_animation</code> | BOOLEAN | Hayır | <code>true</code> | — |
| <code>export_with_geometry</code> | BOOLEAN | Hayır | <code>false</code> | — |

**Çıktı:** STRING <code>model_file</code> + <code>MODEL_INFO</code>. **Önkoşul:** rig uygulanmış MODEL_INFO. **Yaygın hatalar:** rig uygulanmamış bağlam veya API hatası. **En küçük bağlantı:** Rig → <code>TripoAnimateRetargetNode</code> → Preview / Convert.

16 animasyon değeri: <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>.

### Format çıktısı

### TripoConvertNode — Tripo: Convert model

Modeli dönüştürür ve dışa aktarır.

| Girdi | Tür | Zorunlu | Varsayılan | Değerler / aralık |
| --- | --- | --- | --- | --- |
| <code>model_info</code> | MODEL_INFO | Evet | — | üst görev bağlamı |
| <code>format</code> | ENUM | Evet | ilk değer | <code>GLTF</code>, <code>USDZ</code>, <code>FBX</code>, <code>OBJ</code>, <code>STL</code>, <code>3MF</code> |
| <code>quad</code> | BOOLEAN | Hayır | <code>false</code> | — |
| <code>force_symmetry</code> | BOOLEAN | Hayır | <code>false</code> | — |
| <code>face_limit</code> | INT | Hayır | <code>-1</code> | <code>-1</code>–<code>500000</code> |
| <code>flatten_bottom</code> | BOOLEAN | Hayır | <code>false</code> | — |
| <code>flatten_bottom_threshold</code> | FLOAT | Hayır | <code>0.01</code> | <code>0.0</code>–<code>1.0</code> |
| <code>texture_size</code> | INT | Hayır | <code>4096</code> | <code>128</code>–<code>4096</code> |
| <code>texture_format</code> | ENUM | Hayır | <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 | Hayır | <code>false</code> | — |
| <code>scale_factor</code> | FLOAT | Hayır | <code>1.0</code> | en az <code>0</code> |
| <code>with_animation</code> | BOOLEAN | Hayır | <code>true</code> | — |
| <code>pack_uv</code> | BOOLEAN | Hayır | <code>false</code> | — |
| <code>bake</code> | BOOLEAN | Hayır | <code>true</code> | — |
| <code>part_names</code> | STRING multiline | Hayır | boş | satır başına bir ad |
| <code>fbx_preset</code> | ENUM | Hayır | <code>blender</code> | <code>blender</code>, <code>mixamo</code>, <code>3dsmax</code> |
| <code>export_vertex_colors</code> | BOOLEAN | Hayır | <code>false</code> | — |
| <code>export_orientation</code> | ENUM | Hayır | <code>+x</code> | <code>+x</code>, <code>+y</code>, <code>-x</code>, <code>-y</code> |
| <code>animate_in_place</code> | BOOLEAN | Hayır | <code>false</code> | — |

**Çıktı:** STRING <code>model_file</code>. **Önkoşul:** uyumlu MODEL_INFO. **Yaygın hatalar:** desteklenmeyen dönüşüm, geçersiz ayar veya çıktı hatası. **En küçük bağlantı:** MODEL_INFO → <code>TripoConvertNode</code>.

Convert bir çıktı düğümüdür ve <code>MODEL_INFO</code> döndürmez.

## Workflow örnekleri

Preview 3D yalnızca isteğe bağlı ComfyUI görüntüleyicisidir.

~~~mermaid
flowchart LR
    T["Metin"] --> GT["Generate model<br/>mode: text_to_model"]
    IM["Görsel"] --> GI["Generate model<br/>mode: image_to_model"]
    MV["Ön + isteğe bağlı görünümler"] --> GM["Generate model<br/>mode: multiview_to_model"]
    GT --> V["Preview 3D"]
    GI --> V
    GM --> V
~~~

1. **Text to Model:** <code>prompt</code> → <code>text_to_model</code> ile Generate → Preview 3D.
2. **Image to Model:** IMAGE → <code>image</code>, <code>image_to_model</code> modu → Preview 3D.
3. **Multiview to Model:** ön görünüm <code>image</code>; diğerleri <code>image_left</code>, <code>image_back</code>, <code>image_right</code>.
4. **Texture Model:** Generate/Import → MODEL_INFO → Texture → Preview.
5. **Refine Model:** uyumlu taslak → MODEL_INFO → Refine → Preview.
6. **Rig and Retarget:** Generate/Import → Rig → Retarget; MODEL_INFO bağlayın.
7. **Import and Process:** dosya/URL → Import → Segment/Smart low poly/Stylize/Texture.
8. **Convert and Export:** son MODEL_INFO → Convert → format.

### Resmî workflow PNG dosyaları

Aşağıdaki altı PNG gömülü ComfyUI workflow verisi içerir. İndirme bağlantısıyla orijinali kaydedip ComfyUI’ye sürükleyin veya elle yükleyin. Görsellerdeki parametre değerleri yalnızca örnektir; güncel varsayılanlar için parametre tablolarını kullanın.

#### Text to Mesh

![Tripo Generate model ve Preview 3D içeren metinden mesh workflow](/assets/images/docs/comfyui-nodes/text_to_model.png)

Metinden model oluşturur ve <code>model_file</code> değerini Preview 3D’ye gönderir.

<a href="/assets/images/docs/comfyui-nodes/text_to_model.png" download>Orijinal workflow PNG dosyasını indir</a>

#### Image to Mesh

![Load Image, Tripo Generate model ve Preview 3D içeren görüntüden mesh workflow](/assets/images/docs/comfyui-nodes/image_to_model.png)

Görüntüyü yükler, <code>image_to_model</code> modundaki Generate model düğümüne bağlar ve sonucu gösterir.

<a href="/assets/images/docs/comfyui-nodes/image_to_model.png" download>Orijinal workflow PNG dosyasını indir</a>

#### Multiview Images to Mesh

![Üç Load Image, Tripo Generate model ve Preview 3D içeren çoklu görünüm workflow](/assets/images/docs/comfyui-nodes/multiview_to_model.png)

Ön ve isteğe bağlı yan görünümleri <code>multiview_to_model</code> modundaki Generate model düğümüne bağlar.

<a href="/assets/images/docs/comfyui-nodes/multiview_to_model.png" download>Orijinal workflow PNG dosyasını indir</a>

#### Texture a generated model

![Generate model, Texture model ve Preview 3D içeren doku workflow](/assets/images/docs/comfyui-nodes/texture_model.png)

Generate model çıktısındaki <code>MODEL_INFO</code> değerini Texture model düğümüne verir ve iki çıktıyı gösterir.

<a href="/assets/images/docs/comfyui-nodes/texture_model.png" download>Orijinal workflow PNG dosyasını indir</a>

#### Refine a draft Mesh

![Generate model, Refine Draft model ve Preview 3D içeren iyileştirme workflow](/assets/images/docs/comfyui-nodes/refine_model.png)

Uyumlu taslak oluşturur, <code>MODEL_INFO</code> değerini Refine Draft model düğümüne verir ve sonucu gösterir.

<a href="/assets/images/docs/comfyui-nodes/refine_model.png" download>Orijinal workflow PNG dosyasını indir</a>

#### Animation / Rig and export

![Generate model, Rig model, Preview 3D ve Convert model içeren rig ve dışa aktarma workflow](/assets/images/docs/comfyui-nodes/retarget.png)

<a href="/assets/images/docs/comfyui-nodes/retarget.png" download>Orijinal workflow PNG dosyasını indir</a>

## Çıktı ve sorun giderme

İndirmeler varsayılan olarak <code>ComfyUI/output</code> içine yazılır. <code>file_prefix</code> dosyayı adlandırır, <code>output_directory</code> taşır; ikisi de <code>MODEL_INFO</code> ile aktarılır.

| Belirti | Kontrol |
| --- | --- |
| API Key eksik | Düğüm anahtarı, <code>TRIPO_API_KEY</code> veya <code>config.json</code> ayarlayın. |
| Prompt/ön görünüm eksik | Modu ve koşullu girdiyi kontrol edin. |
| Import başlamıyor | Erişilebilir URL veya mevcut dosya verin; URL önceliklidir. |
| Model rig için uygun değil | Uygun karakter modeli kullanın. |
| API görevi başarısız | <code>error_code</code>, <code>error_msg</code>, erişim ve bakiyeyi kontrol edin. |
| Çıktı taşınamıyor | Hedef yolu ve yazma iznini kontrol edin. |
| Düğümler görünmüyor | ComfyUI’yi yeniden başlatın; dizin ve <code>requirements.txt</code> kontrol edin. |
| Yükleme başarısız | Uzantıyı ve ComfyUI yükleme yanıtını kontrol edin. |