3D

3D Model Oluştur

Bir 3D model oluşturma görevi yaratır

POST
/v1/3d/generations

Güncel 3D modelleri almak için GET /v1/models?recommended_for=3d kullanın.

Metin veya görsellerden 3D modeller oluşturun. Bu, asenkron bir API'dir. Oluşturma yanıtları bir görev kimliği döndürür. Durumu öğrenmek için bu kimlikle GET /v1/tasks/{id} uç noktasına sorgu yapın.

İşlem text-to-3d veya image-to-3d şeklindedir. operation alanını boş bırakabilirsiniz: yalnızca istem (prompt) içeren istekler text-to-3d olarak çözümlenir, image veya image_url içeren istekler ise image-to-3d olarak çözümlenir. Eğer operation gönderirseniz, girdilerle eşleşmelidir: image-to-3d bir görsel gerektirir, text-to-3d ise görsel almaz. Eski 3d-generation değeri 400 unsupported_operation hatası döndürür. Her model yalnızca belirli işlemleri destekler; GET /v1/models/{model} üzerinden kontrol edin.

İstek Gövdesi (Request Body)

İsteğe bağlı alanları göndermeden önce, modelin kabul ettiği parametreler için GET /v1/models/{model} uç noktasını kontrol edin. Örnekte yalnızca model ve prompt kullanılmıştır.

modelstringvarsayılan: tripo-h3.1

Kullanılacak model; örneğin tripo-h3.1 veya tripo-p1.0. Belirli bir girdi türüne veya çıktı formatına güvenmeden önce GET /v1/models?recommended_for=3d sorgusu yapın.

operationstring

text-to-3d veya image-to-3d. İsteğe bağlıdır; belirtilmediğinde girdilerden çıkarım yapılır.

promptstringzorunlu

Oluşturulacak 3D modelin 2000 karaktere kadar metin açıklaması. Modeller daha kısa bir sınır belirleyebilir; detaylarına bakın. Image-to-3D istekleri de mevcut modeller için bir prompt gerektirir; aksi takdirde istek 400 prompt is required hatası döndürür.

imagestring

Image-to-3D oluşturma için Base64 kodlu görsel.

image_urlstring

Image-to-3D oluşturma için görselin herkese açık URL adresi.

formatstring

Çıktı formatı; destek ve izin verilen değerler seçilen modele bağlıdır.

qualitystring

Kalite ayarı; destek ve izin verilen değerler seçilen modele bağlıdır.

stylestring

Model için stil ön ayarı.

seedinteger

Seçilen model tarafından desteklendiğinde kullanılan tam sayı (integer) seed değeri.

userstring

Son kullanıcı için benzersiz bir tanımlayıcı. Yalnızca seçilen model kabul ettiğinde gönderin.

Bazı modeller ayrıca n, negative_prompt ve output_format (format parametresinin bir diğer adı) parametrelerini de listeler. Bunları yalnızca modelin detaylarında listelendikleri durumlarda gönderin.

Yanıt (Response)

idstring

Durum sorgulama için görev kimliği.

task_idstring

Adaptör tarafından döndürüldüğünde asenkron görev tanımlayıcı takma adı.

poll_urlstring

Bu görev için durum URL'si. id ile GET /v1/tasks/{id} sorgusu yapın.

statusstring

Görev durumu: pending, processing, completed veya failed.

createdinteger

Görevin oluşturulma zamanına ait Unix zaman damgası.

İstek

curl -X POST "https://api.tokenlab.sh/v1/3d/generations" \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "tripo-h3.1",
    "prompt": "A detailed medieval castle with towers"
  }'

Yanıt

Response
{
  "id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "task_id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "poll_url": "/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
  "status": "pending",
  "created": 1706000000,
  "model": "tripo-h3.1"
}

Yetkilendirme

BearerAuth
AuthorizationBearer <token>

API Anahtarı kimlik doğrulaması. API anahtarlarını Dashboard > API > API Keys bölümünden oluşturun veya yönetin.

Konum: header

Başlıklar

X-TokenLab-Delivery-Policy?string

İstek bazlı Teslimat politikası. API anahtarı ve Çalışma Alanı varsayılanlarını geçersiz kılar. Otomatik olarak önce TokenLab Verified dener ve çıktı, istek kabulü veya kalıcı kaynak oluşturma öncesinde bir kez Official seçeneğine geçiş yapabilir.

Geçerli değerler

  • "auto"
  • "verified"
  • "official"
Idempotency-Key?string

Oluşturma isteğinin güvenli bir şekilde yeniden denenmesini sağlayan isteğe bağlı anahtar. Her görev için UUID gibi yeni ve benzersiz bir değer gönderin. Aynı anahtar ve aynı gövde ile yapılan bir yeniden deneme, orijinal oluşturma isteğinin sonucunu (genellikle orijinal görevi) döndürür ve ikinci bir görev oluşturmaz, göndermez veya ücretlendirmez. Daha önce kabul edilmiş bir anahtara sahip farklı bir gövde, 409 hatası ile reddedilir. 255 karakterden uzun bir anahtar yok sayılır ve bu durumda isteğin idempotency koruması olmaz. Bkz: Idempotency anahtarı ile güvenli yeniden deneme.

Uzunluk1 <= length <= 255

İstek gövdesi

application/json

Yanıt

application/json

application/json

application/json

application/json

application/json

application/json