Ana içeriğe atla
World oluşturma, keşfedilebilir Marble Worlds çıktısını asenkron üretir. Kullanıcının açabileceği veya tekrar dönebileceği ortamlar için Worlds kullanın. Bağımsız model asset gerektiğinde 3D generation kullanın.

​
Girdiler Ve Media Assets

World görevleri seçilen modele ve istek biçimine göre metin, görseller, birden fazla görsel veya video ile başlayabilir. Yeniden kullanılabilir medya promptları için önce media asset hazırlayın, sonra World isteğinde buna referans verin. Media assets ve tamamlanan Worlds yalnızca hesabınızda kullanılabilir.

​
Oluştur Ve İzle

Create yanıtları public task ID ve genellikle poll_url içerir. İlerlemeyi göstermeden önce bu IDyi saklayın, sonra görev completed veya failed olana kadar poll_url ya da GET /v1/tasks/ 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"
  }'

​
Tamamlanan Worlds Yönetimi

Hesabınızdaki tamamlanan Worlds için Worlds listeleme ve detay endpointlerini kullanın. Bekleyen veya başarısız üretimler için task status endpointlerini kullanın. Yalnızca kullanıcı oluşturulan World öğesini ürününüzden bilerek kaldırdığında silin.

​
Yaygın Hatalar

  • Her World modelinin her giriş tipini desteklediğini varsaymayın.
  • İmzalı görsel veya video URLlerini hizmetin yeniden denemelerine yetecek kadar geçerli tutun.
  • Timeout sonrası tekrar denemeden önce dönen task IDyi saklayın.
  • İndirilebilir model dosyaları için keşfedilebilir Worlds yerine 3D generation kullanın.

​
API Referansı

KonuReferans
World OluşturWorld Oluştur
World Durumu AlWorld Durumu Al
Media Asset Yüklemeyi HazırlaMedia Asset Yüklemeyi Hazırla
Media Asset AlMedia Asset Al
Worlds ListeleWorlds Listele
World AlWorld Al
World SilWorld Sil
Asenkron İşlerAsenkron İşler
3D Generation Kılavuzu3D Generation Kılavuzu