Tripo3D

Tripo API'ye giriş

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

Temel URL

https://openapi.tripo3d.ai/v3

Kimlik doğrulama

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

Authorization: Bearer {api_key}

API Keys’yi Tripo Konsolunda 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
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 Metinden 3B model oluşturma
POST /v3/generation/image-to-model Bir görüntüden 3B model oluşturma
POST /v3/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 Metinden resim oluşturma
POST /v3/generation/image-to-image Bir görüntü stilini dönüştürün
POST /v3/generation/image-to-multiview Çoklu görünüm görüntüleri oluşturun
POST /v3/generation/edit-multiview Çoklu görünüm görüntülerini düzenleyin

Modeli İşleme

Uç nokta Açıklama
POST /v3/models/texture Bir modeli dokulandırma
POST /v3/models/convert Model formatını dönüştür
POST /v3/mesh/segment Anlamsal segmentasyon
POST /v3/mesh/complete Mesh tamamlama
POST /v3/mesh/decimate Retopoloji

Animasyon

Uç nokta Açıklama
POST /v3/animations/rig-check Rigging uyumluluğunu kontrol edin
POST /v3/animations/rig Bir model donatmak
POST /v3/animations/retarget Animasyonu yeniden hedefleme

Görev Yönetimi

Uç nokta Açıklama
GET /v3/tasks/{task_id} Bir görevi sorgulama
POST /v3/tasks/list Görevleri toplu olarak sorgulama

Dosya Yönetimi

Uç nokta Açıklama
POST /v3/files Bir dosya yükle

Hesap

Uç nokta Açıklama
GET /v3/account/balance Hesap bakiyesini sorgula
SonrakiHızlı Başlangıç