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:

GirdiAlan
Metinprompt, en fazla 4.000 karakter
Bir görselimage_url veya Base64 ya da veri URL'si olarak image; is_pano halihazırda bir panorama olup olmadığını belirtir
Birkaç görselimages, en fazla 4 adet
Videovideo_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ı

KonuReferans
Dünya OluşturmaDünya Oluşturma
Görev Durumunu AlGörev Durumunu Al
Dünya Durumunu Al (uyumluluk)Dünya Durumunu Al
Medya Varlığı Yüklemeyi HazırlaMedya Varlığı Yüklemeyi Hazırla
Medya Varlığını AlMedya Varlığını Al
Dünyaları ListeleDünyaları Listele
Dünyayı AlDünyayı Al
Dünyayı SilDünyayı Sil
Asenkron İşlerAsenkron İşler
3D Generation Kılavuzu3D Generation Kılavuzu

Bu sayfada