Medya kılavuzları
Worlds
Metin, görsel veya videolardan keşfedilebilir Marble dünyaları oluşturun
Worlds, insanların açıp keşfedebileceği bir Marble ortamı oluşturur. Bir ortam yerine indirilebilir bir nesneye ihtiyacınız varsa, 3D generation kullanın.
Splat'ler, mesh'ler ve panorama görselleri gibi indirilebilir World dosyaları, TokenLab medya sonucu URL'leri ile birlikte otomatik olarak 30 günlük kopyalar halinde saklanır. Etkileşimli World sayfası ve World kayıtları bu şekilde saklanmaz. Bkz. Veri saklama.
Girdiler ve Medya Varlıkları
Bir dünya, modele bağlı olarak metin, bir veya daha fazla görsel ya da videodan başlatılabilir. Marble modellerini (marble-*) GET /v1/models?recommended_for=3d adresinde bulabilirsiniz; bunların işlem türü world-generation şeklindedir. En az bir girdi gönderin:
| Girdi | Alan |
|---|---|
| Metin | prompt, en fazla 4.000 karakter |
| Bir görsel | image_url veya Base64 ya da veri URL'si olarak image; is_pano halihazırda bir panorama olup olmadığını belirtir |
| Birkaç görsel | images, en fazla 4 adet |
| Video | video_url |
| Gelişmiş | world_prompt, yüklenmiş bir medya varlığına referans verebilen yerel bir prompt nesnesi |
İsteğe bağlı alanlar display_name (en fazla 64 karakter), seed, tags (en fazla 10) ve permission şeklindedir. Yeniden kullanılabilir medya bir kez yüklenebilir ve varlık kimliği (asset ID) ile referans verilebilir.
Medya ve World kayıtlarına erişim, API anahtarının sahibi olan organizasyon üzerinden kontrol edilir. Bir dünyayı paylaşmadan önce seçilen modelin permission seçeneklerini gözden geçirin; döndürülen bir varlık veya görüntüleyici URL'si kendi erişim kurallarına sahip olabilir.
Oluşturma ve Sorgulama (Poll)
Oluşturma yanıtı bir görev kimliği (task ID) ve genellikle bir poll_url içerir. Kimliği saklayın, ardından durum completed veya failed olana kadar GET /v1/tasks/{id} ile sorgulama yapın. Worlds poll_url adresi, bir uyumluluk yolu olan /v1/worlds/generations/{id} adresini işaret eder. Bunun yerine /v1/tasks/{id} kullanın.
curl -X POST "https://api.tokenlab.sh/v1/worlds/generations" \
-H "Authorization: Bearer sk-your-api-key" \
-H "Content-Type: application/json" \
-d '{
"model": "marble-1.1",
"prompt": "A quiet coastal town at sunset with narrow alleys and warm lights"
}'Oluşturma yanıtından gelen id ile görevi sorgulayın:
curl "https://api.tokenlab.sh/v1/tasks/$TASK_ID" \
-H "Authorization: Bearer sk-your-api-key"Tamamlanmış Dünyaları Yönetme
Hesabınızda bulunan tamamlanmış dünyalar için POST /v1/worlds/list ve GET /v1/worlds/{id} komutlarını, bir dünyayı kaldırmak için ise DELETE /v1/worlds/{id} komutunu kullanın. Bekleyen veya başarısız olan oluşturma görevleri için GET /v1/tasks/{id} kullanın. Yalnızca kullanıcı oluşturulan dünyayı ürününüzden kasıtlı olarak kaldırdığında silme işlemi yapın.
Yaygın Hatalar
- Her dünya modelinin her girdi türünü desteklediğini varsaymayın.
- İmzalı görsel veya video URL'lerini, servis yeniden denemeleri için yeterince uzun süre geçerli tutun.
- Zaman aşımından sonra yeniden denemeden önce döndürülen görev kimliğini saklayın.
- Keşfedilebilir dünyalar yerine indirilebilir model dosyaları için 3D generation kullanın.
API Referansı
| Konu | Referans |
|---|---|
| Dünya Oluşturma | Dünya Oluşturma |
| Görev Durumunu Al | Görev Durumunu Al |
| Dünya Durumunu Al (uyumluluk) | Dünya Durumunu Al |
| Medya Varlığı Yüklemeyi Hazırla | Medya Varlığı Yüklemeyi Hazırla |
| Medya Varlığını Al | Medya Varlığını Al |
| Dünyaları Listele | Dünyaları Listele |
| Dünyayı Al | Dünyayı Al |
| Dünyayı Sil | Dünyayı Sil |
| Asenkron İşler | Asenkron İşler |
| 3D Generation Kılavuzu | 3D Generation Kılavuzu |