# Tripo Eklentileri

Tripo'yu 3B içerik oluşturduğunuz araçların içinden doğrudan kullanın. İş akışınıza uygun eklentiyi seçin, indirin, bir Tripo API anahtarı bağlayın ve editörünüzden ayrılmadan model oluşturun.

## Desteklenen eklentiler

| Eklenti       | Tripo sürümü | Uyumlu sürüm | En uygun kullanım                                 | İndir                                                                                                                               |
| ------------- | ------------ | ------------ | ------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------- |
| Unity         | `1.0.1`      | `Unity 2022+` | Oyun varlıklarını oluşturma ve içe aktarma        | <a class="plugin-download-button" href="https://cdn-web.tripo3d.ai/plugin/tripo-unity.zip" download>İndir</a>     |
| Unreal Engine | `1.0`        | `5.6.0`      | Editör ve Blueprint iş akışları                   | <a class="plugin-download-button" href="https://cdn-web.tripo3d.ai/plugin/tripo-unreal.zip" download>İndir</a>   |
| Blender       | `0.7.3`      | `3.0+`       | Daha sonra düzenlemek üzere temel model oluşturma | <a class="plugin-download-button" href="https://cdn-web.tripo3d.ai/plugin/tripo-blender.zip" download>İndir</a> |
| Godot         | `0.02`       | `4.4+`    | Editör ve `Node3D` iş akışları                    | <a class="plugin-download-button" href="https://cdn-web.tripo3d.ai/plugin/tripo-godot.zip" download>İndir</a>     |
| Cocos Creator | `1.0.0`      | `3.8.6+`     | Cocos projesi içinde varlık oluşturma             | <a class="plugin-download-button" href="https://cdn-web.tripo3d.ai/plugin/tripo-cocos.zip" download>İndir</a>     |
| ComfyUI       | `1.1.21`     | `0.3.14` | Düğüm tabanlı 3B oluşturma iş akışları            | <a class="plugin-download-button" href="https://cdn-web.tripo3d.ai/plugin/tripo-comfyUI.zip" download>İndir</a> |

Her eklenti farklı bir Tripo özellik kümesi sunar. Aşağıdaki örnekler yalnızca ilgili pakette bulunan davranışları açıklar.

## Eklenti kullanım örnekleri

### Unity — Oyun nesnesi oluşturma

**Kullanım senaryosu.** Bir sahnenin prototipini hazırlarken yer tutucu veya üretime başlangıç olacak bir varlık oluşturun.

**Adımlar.**

1. `Tools > Tripo API Unity` menüsünü açın ve API anahtarınızı yapılandırın.
2. **Image to Model** seçeneğini belirleyin, bir görsel yükleyin ve oluşturmayı başlatın.
3. Görevin tamamlanmasını bekleyin; eklenti indirilen modeli projeye aktarır.

Paket, isteğe bağlı yerel **Text to Model** çalışma zamanı akışı için `TripoRuntimeCore` bileşenini de sunar:

```csharp
GetComponent<TripoRuntimeCore>()
  .SetAPIKey("<TRIPO_API_KEY>")
  .SetTextPrompt("a stylized wooden treasure chest")
  .TextToModel();
```

**Sonuç.** Oluşturulan varlık Unity'de malzeme ayarı, sahneye yerleştirme veya daha fazla düzenleme için kullanılabilir.

<a class="plugin-download-button" href="https://cdn-web.tripo3d.ai/plugin/tripo-unity.zip" download>İndir</a>

### Unreal Engine — Blueprint üzerinden oluşturma

**Kullanım senaryosu.** Bir Unreal editör aracına veya Blueprint tabanlı prototipe model oluşturma özelliği ekleyin.

**Adımlar.**

1. Eklentinin Blueprint düğümleriyle metin, görüntü veya çoklu görünüm oluşturma görevi başlatın.
2. Tamamlanmasını beklemek için geri çağırma ve görev durumu düğümlerini kullanın.
3. Döndürülen model URL'sini indirme düğümüne aktarın. Çalışma zamanında görüntüleme için paketin belgelerinde belirtilen ayrı glTFRuntime eklentisi gerekir.

![Tripo modellerini oluşturmak, sorgulamak ve indirmek için Unreal Engine Blueprint düğümleri](/assets/images/docs/plugins/unreal-blueprint.jpg)

**Sonuç.** Oluşturulan model editöre aktarılmak üzere indirilebilir veya çalışma zamanında görüntüleme iş akışına gönderilebilir.

<a class="plugin-download-button" href="https://cdn-web.tripo3d.ai/plugin/tripo-unreal.zip" download>İndir</a>

### Blender — Referans görüntüden oluşturma

**Kullanım senaryosu.** Bir görüntüden temel mesh oluşturun, ardından Blender'da modelleme ve malzeme çalışmalarına devam edin.

**Adımlar.**

1. `View3D > Sidebar > Tripo 3D` panelini açın ve API anahtarınızı bağlayın.
2. Görüntüden modele seçeneğini belirleyin, referans görüntüyü ekleyin ve yüz sınırı, doku, PBR veya dörtgen mesh gibi seçenekleri ayarlayın.
3. Oluşturmayı başlatın ve eklentinin sonucu indirip içe aktarmasını bekleyin.

**Sonuç.** GLB veya FBX Blender'a aktarılır ve standart modelleme araçlarıyla düzenlenebilir.

<a class="plugin-download-button" href="https://cdn-web.tripo3d.ai/plugin/tripo-blender.zip" download>İndir</a>

### Godot — Oluşturulan modeli Node3D olarak ekleme

**Kullanım senaryosu.** Godot editöründe veya yerel çalışma zamanı iş akışında bir 3B nesne oluşturup sahne ağacına ekleyin.

**Adımlar.** Eklentide API anahtarını yapılandırın, bir giriş ve görev düğümü oluşturun, ardından görevin tamamlanmasını bekleyin:

Aşağıdaki örnek bir metin görevi kullanır. Görüntü görevi için kaynak görüntüyü `TripoUploadImage` ile yükleyin ve modeli `TripoImageToModel` ile oluşturun.

```gdscript
var input = TripoTextToModelInput.new()
input.prompt = "a stylized wooden treasure chest"

var task = TripoTextToModel.new()
task.input = input
add_child(task)

if await task.launch() == TripoTask.TaskError.eSuccess:
    add_child(task.save_to_node())
```

**Sonuç.** Oluşturulan model önizlenebilir, kaydedilebilir veya geçerli sahneye `Node3D` olarak eklenebilir.

<a class="plugin-download-button" href="https://cdn-web.tripo3d.ai/plugin/tripo-godot.zip" download>İndir</a>

### Cocos Creator — Oluşturulan proje varlığını kaydetme

**Kullanım senaryosu.** Cocos Creator'dan ayrılmadan metin veya görüntüden bir model oluşturun.

**Adımlar.**

1. **Tripo Model Generator** panelini açın ve API anahtarınızı bağlayın.
2. Metin veya görüntü girişini seçin, oluşturma seçeneklerini yapılandırın ve görevi başlatın.
3. Uzantının tamamlanan modeli projeye indirmesini bekleyin.

**Sonuç.** GLB veya FBX `assets/resources` altına yazılır ve geçerli projede kullanılabilir.

<a class="plugin-download-button" href="https://cdn-web.tripo3d.ai/plugin/tripo-cocos.zip" download>İndir</a>

### ComfyUI — Metinden 3B'ye iş akışı oluşturma

**Kullanım senaryosu.** Tripo oluşturma işlemini mevcut düğüm tabanlı görüntü veya varlık işlem hattına bağlayın.

**Adımlar.**

1. Bir metin girişini Tripo model oluşturma düğümüne bağlayın.
2. API anahtarını, oluşturma modunu, model sürümünü ve çıktı seçeneklerini belirleyin.
3. Sonucu 3B önizleme düğümüne bağlayın ve kuyruğu çalıştırın.

![Oluşturulan model önizlemesini içeren ComfyUI metinden 3B'ye iş akışı](/assets/images/docs/plugins/comfyui-text-to-model.jpg)

**Sonuç.** Model iş akışında önizlenir ve otomatik olarak `ComfyUI/output` altına kaydedilir.

<a class="plugin-download-button" href="https://cdn-web.tripo3d.ai/plugin/tripo-comfyUI.zip" download>İndir</a>

## Kurulum ve başlangıç

### Unity

1. ZIP dosyasını indirin ve ayıklayın.
2. `package.json` içeren ayıklanmış eklenti dizinini projenizin `Packages` dizinine taşıyın.
3. Projeyi yeniden açın ve `Tools > Tripo API Unity` seçeneğini belirleyin.

### Unreal Engine

1. ZIP dosyasını indirip Unreal projenizdeki `Plugins/Tripo3D` dizinine ayıklayın.
2. Proje ayarlarında eklentiyi etkinleştirin.
3. Unreal Editor'ı yeniden başlatın.

### Blender

1. `Edit > Preferences > Add-ons` bölümünü açın.
2. **Install from Disk** seçeneğini belirleyin, indirilen ZIP dosyasını seçin ve **Tripo 3D** eklentisini etkinleştirin.
3. Eklentiyi `View3D > Sidebar > Tripo 3D` bölümünden açın.

### Godot

1. ZIP dosyasını ayıklayın ve `addons/tripo-godot` dizinini projenizin `addons` dizinine kopyalayın.
2. `Project Settings > Plugins` bölümünü açın ve Tripo eklentisini etkinleştirin.
3. Tripo editör panelini açın veya bir sahnede sağlanan düğümleri kullanın.

### Cocos Creator

1. `Extension > Extension Manager` bölümünü açın.
2. **Project** veya **Global** seçeneğini belirleyin, `+` düğmesine tıklayın ve indirilen ZIP dosyasını içe aktarın.
3. Uzantıyı etkinleştirin, ardından **Tripo Model Generator** panelini açın.

Standart ZIP içe aktarma iş akışı için [Cocos Creator 3.8 uzantı kurulum kılavuzuna](https://docs.cocos.com/creator/3.8/manual/en/editor/extension/install.html) bakın.

### ComfyUI

1. ZIP dosyasını `ComfyUI/custom_nodes/ComfyUI-Tripo` dizinine ayıklayın.
2. Bağımlılıklarını ComfyUI Python ortamından yükleyin:

```bash
python -m pip install -r ComfyUI/custom_nodes/ComfyUI-Tripo/requirements.txt
```

3. ComfyUI'yi yeniden başlatın ve bir Tripo iş akışı yükleyin veya oluşturun.

## API anahtarını yapılandırma

[Tripo API Keys sayfasında](https://platform.tripo3d.ai/api-keys) bir anahtar oluşturun ve görevi başlatmadan önce seçtiğiniz eklentiye girin.

API anahtarı gizli bir kimlik bilgisidir. Anahtarı kaynak kontrolüne göndermeyin, ekran görüntülerine eklemeyin, günlüklere yazdırmayın veya herkese açık bir istemci derlemesinin içinde dağıtmayın. Genel API kuralları için [Kimlik doğrulama](/tr/docs/authentication) sayfasına bakın.

## İlgili kaynaklar

- [Kimlik doğrulama](/tr/docs/authentication)
- [SDK entegrasyonu](/tr/docs/sdk)
- [Tripo API Keys](https://platform.tripo3d.ai/api-keys)
