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ı alanlar | Notlar |
|---|---|---|---|
| Metinden 3D'ye | model, prompt | format, quality, style, seed | Bir açıklamadan yeni bir varlık oluşturmak için en iyisidir |
| Görselden 3D'ye | model, image_url veya image; ayrıca model listelediğinde prompt | format, quality, style, seed | Yalnı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ı
glbweb önizlemeleri için iyi çalışır.fbxveobj, 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
qualitydeğ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_iddeğerini kaydedin.
Yaygın Hatalar
| Belirti | Olası neden | Çözüm |
|---|---|---|
| Oluşturma yanıtında varlık URL'si yok | 3D oluşturma asenkrondur | Terminal durumuna ulaşana kadar yoklayın |
| İstenen format eksik | Model bu formatı döndürmedi | model_url değerine geri dönün veya formatı destekleyen bir model seçin |
| Görselden 3D'ye reddedildi | Seçilen model yalnızca metin destekliyor veya görsel URL'sine ulaşılamıyor | Model ayrıntılarını kontrol edin ve URL'yi doğrulayın |
| Yinelenen varlıklar | Zaman aşımından sonra yeniden deneme yolu görevi 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 |
| Faturalandırma ve Fiyatlandırma | Faturalandırma ve Fiyatlandırma |