# 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](/tr/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,
"status": "error",
"message": "You don't have enough credit to create this task",
"suggestion": "Please purchase more credit",
"request_id": "req_abc123"
}
```
### 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 |
| status | dize | Başarısızlık durumunda `error` |
| 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 |
| request_id | dize | Sorun giderme için benzersiz istek tanımlayıcı, başarısızlık durumunda 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
Aşağıdaki görev kimliği örnektir; sonraki isteklerde API tarafından döndürülen `task_id` değerini kullanın.
```
POST /v3/generation/text-to-model
-> {"code": 0, "data": {"task_id": "123e4567-e89b-42d3-a456-426614174000"}}
GET /v3/tasks/123e4567-e89b-42d3-a456-426614174000
-> {"code": 0, "data": {"status": "running", "progress": 50}}
GET /v3/tasks/123e4567-e89b-42d3-a456-426614174000
-> {"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
3D oluşturma uç noktaları H Serisi ve P Serisi olarak ikiye ayrılır; bu seriler farklı modelleri ve parametreleri destekler. Her uç nokta sayfasının üst kısmından seriler arasında geçiş yapabilirsiniz.
| Uç nokta | Açıklama |
| :-: | :-: |
| `POST /v3/generation/text-to-model` ([H Serisi](/tr/docs/generation-text-to-model/standard), [P Serisi](/tr/docs/generation-text-to-model/p)) | Metinden 3B model oluşturma |
| `POST /v3/generation/image-to-model` ([H Serisi](/tr/docs/generation-image-to-model/standard), [P Serisi](/tr/docs/generation-image-to-model/p)) | Bir görüntüden 3B model oluşturma |
| `POST /v3/generation/multiview-to-model` ([H Serisi](/tr/docs/generation-multiview-to-model/standard), [P Serisi](/tr/docs/generation-multiview-to-model/p)) | Ç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`](/tr/docs/generation-text-to-image) | Metinden resim oluşturma |
| [`POST /v3/generation/image-to-image`](/tr/docs/generation-image-to-image) | Bir görüntü stilini dönüştürün |
| [`POST /v3/generation/image-to-multiview`](/tr/docs/generation-image-to-multiview) | Çoklu görünüm görüntüleri oluşturun |
| [`POST /v3/generation/edit-multiview`](/tr/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`](/tr/docs/models-texture) | Bir modeli dokulandırma |
| [`POST /v3/models/convert`](/tr/docs/models-convert) | Model formatını dönüştür |
| [`POST /v3/mesh/segment`](/tr/docs/mesh-segment) | Anlamsal segmentasyon |
| [`POST /v3/mesh/complete`](/tr/docs/mesh-complete) | Mesh tamamlama |
| [`POST /v3/mesh/decimate`](/tr/docs/mesh-decimate) | Retopoloji |
### Animasyon
| Uç nokta | Açıklama |
| :-: | :-: |
| [`POST /v3/animations/rig-check`](/tr/docs/animations-rig-check) | Rigging uyumluluğunu kontrol edin |
| [`POST /v3/animations/rig`](/tr/docs/animations-rig) | Bir model donatmak |
| [`POST /v3/animations/retarget`](/tr/docs/animations-retarget) | Animasyonu yeniden hedefleme |
### Görev Yönetimi
| Uç nokta | Açıklama |
| :-: | :-: |
| [`GET /v3/tasks/{task_id}`](/tr/docs/task-query) | Bir görevi sorgulama |
| [`POST /v3/tasks/list`](/tr/docs/task-batch-query) | Görevleri toplu olarak sorgulama |
### Dosya Yönetimi
| Uç nokta | Açıklama |
| :-: | :-: |
| [`POST /v3/files`](/tr/docs/files) | Bir dosya yükle |
### Hesap
| Uç nokta | Açıklama |
| :-: | :-: |
| [`GET /v3/account/balance`](/tr/docs/account) | Hesap bakiyesini sorgula |
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.
{
"code":2010,
"status":"error",
"message":"You don't have enough credit to create this task",
"suggestion":"Please purchase more credit",
"request_id":"req_abc123"
}
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
status
dize
Başarısızlık durumunda error
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
request_id
dize
Sorun giderme için benzersiz istek tanımlayıcı, başarısızlık durumunda döndürülür
Eşzamansız Görev Modeli
Çoğu nesil API, eşzamansız bir görev modeli kullanır:
Görev oluştur - Bir görev oluşturmak ve task_id almak için POST isteği gönderin
Sonuçlar için anket - Görev durumunu ve sonucunu sorgulamak için GET /v3/tasks/{task_id}'yi kullanın
Aşağıdaki görev kimliği örnektir; sonraki isteklerde API tarafından döndürülen task_id değerini kullanın.
POST /v3/generation/text-to-model
-> {"code": 0, "data": {"task_id": "123e4567-e89b-42d3-a456-426614174000"}}
GET /v3/tasks/123e4567-e89b-42d3-a456-426614174000
-> {"code": 0, "data": {"status": "running", "progress": 50}}
GET /v3/tasks/123e4567-e89b-42d3-a456-426614174000
-> {"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
3D oluşturma uç noktaları H Serisi ve P Serisi olarak ikiye ayrılır; bu seriler farklı modelleri ve parametreleri destekler. Her uç nokta sayfasının üst kısmından seriler arasında geçiş yapabilirsiniz.