3D Üretimi - TokenLab

3D üretimi asenkron bir süreçtir. POST /v1/3d/generations bir TokenLab görevi oluşturur; tamamlanmış durum yanıtları, model_url gibi indirilebilir model varlıkları döndürür ve mevcut olduğunda format-spesifik URL’leri içerir.

Girdi Türünü Seçin

İş Akışı	Gerekli girdi	Opsiyonel alanlar	Notlar
Metinden-3D	`model`, `prompt`	`format`, `quality`, `style`, `seed`	Bir tanımdan yeni bir varlık oluşturmak için en iyisi
Resimden-3D	`model`, `prompt`, `image` veya `image_url`	`format`, `quality`, `style`, `seed`	Seçilen modelin resim girişi desteklediği durumlarda kullanın

Hangi seçeneklerin sunulacağına karar vermeden önce model kataloğunu sorgulayın:

curl "https://api.tokenlab.sh/v1/models?recommended_for=3d" \
  -H "Authorization: Bearer sk-your-api-key"

Her 3D modelin her iki girdi türünü veya her çıktı formatını desteklediğini varsaymayın. image, image_url, format, quality, style veya seed göndermeden önce seçilen model sözleşmesini kontrol edin.

3D Görevi Oluşturun

curl https://api.tokenlab.sh/v1/3d/generations \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "tripo3d-v2.5",
    "prompt": "Temiz topolojiye sahip stilize edilmiş düşük poli robot maskotu",
    "format": "glb",
    "quality": "standard"
  }'

Resimden-3D için, mümkünse bir genel image_url kullanın. Müşterinizin kasıtlı olarak özel medya gönderdiği ve arka uç sisteminizin daha büyük istek gövdelerine hazır olduğu durumlarda yalnızca inline/base64 image kullanın.

Çıktı Formatı Seçenekleri

glb, genellikle web önizlemeleri için en güvenli varsayılandır.
fbx ve obj, seçilen model bunları destekliyorsa DCC hatları için faydalıdır.
usdz, model tarafından sunulduğunda Apple AR iş akışları için faydalıdır.
Daha yüksek quality değerleri gecikmeyi ve maliyeti artırabilir. Bunları gizli varsayılanlar değil, açık kullanıcı seçimleri olarak sunun.
seed, yalnızca model bunu dikkate alıyorsa yeniden üretilebilirlik için faydalıdır.

Varlıkları Anket Yapın ve Saklayın

Öncelikle döndürülen poll_url’u kullanın. Müşterinizin sabit bir yola ihtiyacı varsa, GET /v1/tasks/{id} kullanın.

curl "https://api.tokenlab.sh/v1/tasks/$TASK_ID" \
  -H "Authorization: Bearer sk-your-api-key"

Tamamlanan görevler model_url döndürür ve glb_url, fbx_url, obj_url veya usdz_url içerebilir. Kullanıcıların tekrar erişim, sürüm geçmişi veya uzun süreli indirmelere ihtiyacı varsa, seçilen varlığı kendi ürününüzde indirin veya önbelleğe alın.

Üretim Kontrol Listesi

task_id, poll_url, model, talep edilen format ve kendi varlık kayıt kimliğinizi saklayın.
Sayfa yenilemesinden sonra anket yapmaya devam edin, yeni bir görev oluşturmaktan kaçının.
Görevi oluşturmadan önce kaynak resim boyutunu ve erişilebilirliğini doğrulayın.
Kullanıcının varlığa erişim izni yoksa, oluşturulan varlık URL’lerini genel sayfalardan uzak tutun.
Daha sonra uzlaşma için mevcut olduğunda billing_transaction_id kaydedin.

Yaygın Hatalar

Belirti	Muhtemel neden	Çözüm
Oluşturma yanıtında varlık URL’si yok	3D üretimi asenkron	Terminal duruma kadar anket yapın
Talep edilen format eksik	Model o formatı döndürmedi	`model_url`’a geri dönün veya formatı destekleyen bir model seçin
Resimden-3D reddedildi	Seçilen model yalnızca metin destekli veya resim URL’si erişilemez	Model sözleşmesini kontrol edin ve URL’yi doğrulayın
Çift varlıklar	Yeniden deneme yolu görevi zaman aşımından sonra yeniden oluşturdu	Yeniden denemeden önce görev kimliğini saklayın

API Referansı

Konu	Referans
3D Oluştur	3D Oluştur
3D Durumunu Al	3D Durumunu Al
Görev Durumunu Al	Görev Durumunu Al
Modelleri Listele	Modelleri Listele
Faturalama & Fiyatlandırma	Faturalama & Fiyatlandırma

​Girdi Türünü Seçin

​3D Görevi Oluşturun

​Çıktı Formatı Seçenekleri

​Varlıkları Anket Yapın ve Saklayın

​Üretim Kontrol Listesi

​Yaygın Hatalar

​API Referansı