Medya kılavuzları

3D oluşturma

Metin veya görsellerden indirilebilir 3D modeller oluşturun

3D oluşturma asenkrondur. POST /v1/3d/generations bir TokenLab görevi oluşturur; tamamlanan durum yanıtları, model_url ve mevcut olduğunda formata özel URL'ler gibi indirilebilir model varlıklarını döndürür.

İndirilebilir 3D model dosyaları 30 günlük otomatik kopyalar olarak saklanır ve bunların URL'leri TokenLab medya sonucu URL'leridir. Görev kayıtları ve ayrı olarak kaydedilen varlıklar kendi yaşam döngülerini izler. Bkz. Veri saklama.

Giriş türünü seçin

GirişGerekliİsteğe bağlı alanlarNotlar
Metinden 3D'yemodel, promptformat, quality, style, seedBir açıklamadan yeni bir varlık oluşturmak için en iyisidir
Görselden 3D'yemodel, image_url veya image; ayrıca model listelediğinde promptformat, quality, style, seedYalnızca seçilen model görsel girişini desteklediğinde kullanın

operation isteğe bağlıdır ve text-to-3d veya image-to-3d değerlerini alır. Eğer belirtmezseniz, TokenLab image veya image_url gönderdiğinizde image-to-3d, aksi takdirde text-to-3d kullanır. Eğer gönderirseniz, girişlerle eşleşmelidir. text-to-3d özelliğine sahip bir model istemleri (prompt) kabul eder; image-to-3d özelliğine sahip bir model ise görsel girişini kabul eder.

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

Her 3D modelin her iki giriş 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 modelin ayrıntılarını 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": "tripo-h3.1",
    "prompt": "A stylized low-poly robot mascot with clean topology"
  }'

Görselden 3D'ye dönüştürme için, kaynak internetten getirilebiliyorsa bir https URL'si kullanın. Satır içi base64 image değerini yalnızca ayrıntılarında image listelenen bir modelde kullanın; bazı modeller yalnızca image_url kabul eder.

Çıktı formatları

  • glb web önizlemeleri için iyi çalışır.
  • fbx ve obj, seçilen model desteklediğinde DCC iş akışları için kullanışlıdır.
  • usdz, model tarafından sunulduğunda Apple AR iş akışları için kullanışlıdır.
  • Daha yüksek quality değerleri bekleme süresini ve maliyeti artırabilir. Bu seçimi kullanıcıya gösterin.
  • seed, yalnızca destekleyen modellerde tekrarlanabilirliği etkiler.

Tamamlanan modeli alın

Döndürülen id veya task_id ile GET /v1/tasks/{id} çağrısı yapı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şime, sürüm geçmişine veya uzun süreli indirmelere ihtiyacı varsa, seçilen varlığı kendi ürününüzde indirin veya önbelleğe alın.

Sonucu erişilebilir tutun

  • task_id, poll_url, model, istenen format ve kendi varlık kayıt kimliğinizi kalıcı hale getirin.
  • Yinelenen bir görev oluşturmak yerine sayfa yenilendikten sonra yoklamaya (polling) devam edin.
  • Görevi oluşturmadan önce kaynak görsel boyutunu ve erişilebilirliğini doğrulayın.
  • Kullanıcının varlığa erişim izni yoksa, oluşturulan varlık URL'lerini herkese açık sayfalardan uzak tutun.
  • Daha sonra mutabakat için mevcut olduğunda billing_transaction_id değerini kaydedin.

Yaygın Hatalar

BelirtiOlası nedenÇözüm
Oluşturma yanıtında varlık URL'si yok3D oluşturma asenkrondurTerminal durumuna ulaşana kadar yoklayın
İstenen format eksikModel bu formatı döndürmedimodel_url değerine geri dönün veya formatı destekleyen bir model seçin
Görselden 3D'ye reddedildiSeçilen model yalnızca metin destekliyor veya görsel URL'sine ulaşılamıyorModel ayrıntılarını kontrol edin ve URL'yi doğrulayın
Yinelenen varlıklarZaman aşımından sonra yeniden deneme yolu görevi yeniden oluşturduYeniden denemeden önce görev kimliğini saklayın

API Referansı

KonuReferans
3D Oluştur3D Oluştur
3D Durumunu Al3D Durumunu Al
Görev Durumunu AlGörev Durumunu Al
Modelleri ListeleModelleri Listele
Faturalandırma ve FiyatlandırmaFaturalandırma ve Fiyatlandırma

Bu sayfada