# Tripo API'ye giriş

Tripo3D, metinden 3D'ye, görüntüden 3D'ye, rigging, mesh düzenleme ve diğer yetenekleri sağlayan AI- destekli bir 3D oluşturma platformudur. Tripo API ile geliştiriciler yüksek kaliteli 3D içerik üretimini kendi ürünlerine entegre edebilirler.

> Çin'den erişiyorsanız lütfen Çin sitesini ziyaret edin: [developers.tripo3d.com](https://developers.tripo3d.com)

## Temel URL

```baseurl
https://openapi.tripo3d.ai/v3
```

## Kimlik doğrulama

Tüm API istekleri, istek başlığında bir API Key içermelidir:

```apikey
Authorization: Bearer {api_key}
```

API Keys'yi [Tripo Konsolunda](/en/keys) oluşturabilir ve yönetebilirsiniz.

## Birleşik Yanıt Formatı

### Başarı Yanıtı

```json
{
  "code": 0,
  "data": {
    ...
  }
}
```

### Hata Yanıtı

```json
{
  "code": 2010,
  "message": "Insufficient credits",
  "suggestion": "Please top up your account"
}
```

### Ortak Alanlar

| Parametre | Tür | Açıklama |
| :-: | :-: | :-: |
| code | tamsayı | Durum kodu. `0` başarıyı gösterir ve `0` olmayan herhangi bir değer bir hatayı gösterir |
| data | nesne | Yalnızca başarı durumunda döndürülen iş verileri |
| message | dize | Hata açıklaması, yalnızca başarısızlık durumunda döndürülür |
| suggestion | dize | Önerilen düzeltme, yalnızca başarısızlık durumunda geri döndürülür |

## Eşzamansız Görev Modeli

Çoğu nesil API, eşzamansız bir görev modeli kullanır:

1. **Görev oluştur** - Bir görev oluşturmak ve `task_id` almak için POST isteği gönderin
2. **Sonuçlar için anket** - Görev durumunu ve sonucunu sorgulamak için `GET /v3/tasks/{task_id}`'yi kullanın

```
POST /v3/generation/text-to-model  ->  {"code": 0, "data": {"task_id": "task_abc123"}}
                                                |
                                                v
GET  /v3/tasks/task_abc123          ->  {"code": 0, "data": {"status": "running", "progress": 50}}
                                                |
                                                v
GET  /v3/tasks/task_abc123          ->  {"code": 0, "data": {"status": "success", "output": {...}}}
```

### Görev Durumları

| Durum | Açıklama |
| :-: | :-: |
| `queued` | Sıraya alındı |
| `running` | Koşu |
| `success` | Başarılı |
| `failed` | Başarısız |
| `cancelled` | İptal edildi |

## API Sürümü

Güncel sürüm: **v3**

## Uç Noktaya Genel Bakış

### 3D Model Oluşturma

| Uç nokta | Açıklama |
| :-: | :-: |
| [`POST /v3/generation/text-to-model`](/en/docs/generation-text-to-model) | Metinden 3B model oluşturma |
| [`POST /v3/generation/image-to-model`](/en/docs/generation-image-to-model) | Bir görüntüden 3B model oluşturma |
| [`POST /v3/generation/multiview-to-model`](/en/docs/generation-multiview-to-model) | Çoklu görünüm görüntülerinden 3 boyutlu bir model oluşturun |

### Görüntü Üretimi

| Uç nokta | Açıklama |
| :-: | :-: |
| [`POST /v3/generation/text-to-image`](/en/docs/generation-text-to-image) | Metinden resim oluşturma |
| [`POST /v3/generation/image-to-image`](/en/docs/generation-image-to-image) | Bir görüntü stilini dönüştürün |
| [`POST /v3/generation/image-to-multiview`](/en/docs/generation-image-to-multiview) | Çoklu görünüm görüntüleri oluşturun |
| [`POST /v3/generation/edit-multiview`](/en/docs/generation-edit-multiview) | Çoklu görünüm görüntülerini düzenleyin |

### Modeli İşleme

| Uç nokta | Açıklama |
| :-: | :-: |
| [`POST /v3/models/texture`](/en/docs/models-texture) | Bir modeli dokulandırma |
| [`POST /v3/models/convert`](/en/docs/models-convert) | Model formatını dönüştür |
| [`POST /v3/mesh/segment`](/en/docs/mesh-segment) | Anlamsal segmentasyon |
| [`POST /v3/mesh/complete`](/en/docs/mesh-complete) | Mesh tamamlama |
| [`POST /v3/mesh/decimate`](/en/docs/mesh-decimate) | Retopoloji |

### Animasyon

| Uç nokta | Açıklama |
| :-: | :-: |
| [`POST /v3/animations/rig-check`](/en/docs/animations-rig-check) | Rigging uyumluluğunu kontrol edin |
| [`POST /v3/animations/rig`](/en/docs/animations-rig) | Bir model donatmak |
| [`POST /v3/animations/retarget`](/en/docs/animations-retarget) | Animasyonu yeniden hedefleme |

### Görev Yönetimi

| Uç nokta | Açıklama |
| :-: | :-: |
| [`GET /v3/tasks/{task_id}`](/en/docs/task-query) | Bir görevi sorgulama |
| [`POST /v3/tasks/list`](/en/docs/task-batch-query) | Görevleri toplu olarak sorgulama |

### Dosya Yönetimi

| Uç nokta | Açıklama |
| :-: | :-: |
| [`POST /v3/files`](/en/docs/files) | Bir dosya yükle |

### Hesap

| Uç nokta | Açıklama |
| :-: | :-: |
| [`GET /v3/account/balance`](/en/docs/account) | Hesap bakiyesini sorgula |