Skip to main content
World Labs Marble ile keşfedilebilir 3D dünyalar oluşturun. Bu API asenkrondur: oluşturma yanıtları bir görev kimliği ve durum kontrolleri için poll_url döndürür. Desteklenen modeller marble-1.0, marble-1.1 ve marble-1.1-plus modelleridir. World Labs marble-1.0-draft modelini belgeler, ancak TokenLab bu endpoint içinde draft generation özelliğini henüz sunmaz.

İstek Gövdesi

string
varsayılan:"marble-1.0"
Kullanılacak Marble modeli: marble-1.0, marble-1.1 veya marble-1.1-plus.
string
Yalnızca metin üretimi için ya da görüntü/video girişleriyle rehber olarak kullanılacak metin promptu.
object
Gelişmiş çağrılar için native World Labs world_prompt nesnesi. Desteklenen prompt türleri text, image, multi-image ve video.
string
Base64 veya data URL görüntü promptu.
string
Görüntü URL promptu.
array
Kısa yoldan multi-image generation için birden çok görüntü promptu. En fazla 4 görüntü sağlayın. Native World Labs reconstruction mode için world_prompt.type="multi-image", reconstruct_images: true ve en fazla 8 görüntü gönderin.
string
Video URL promptu.
boolean | string
Görüntü girişlerinde mevcut panorama için true, normal tek görüntü için false ya da auto ayarlayın.
integer
0 ile 4294967295 arasında isteğe bağlı seed.
string
Upstream dünya için isteğe bağlı görünen ad, en fazla 64 karakter.
array
İsteğe bağlı World Labs etiketleri. En fazla 10 etiket, her biri en fazla 32 karakter.
object
İsteğe bağlı World Labs permission nesnesi.

Yanıt

string
Polling için genel görev IDsi.
string
Asenkron görev tanımlayıcı aliası.
string
World Labs işlem kimliği.
string
Bu görev için tercih edilen polling URLsi.
string
Görev durumu: pending, processing, completed veya failed.
string
Tamamlandığında oluşturulan Marble dünya URLsi.
string
Varsa collider mesh GLB URLsi.
string
Varsa panorama görüntü URLsi.

Fiyatlandırma

World Labs credits üzerinden ücretlendirir. TokenLab istek türü maksimumunu önceden düşer ve tamamlanan operation içinde cost.total_credits varsa gerçek credits üzerinden kapatır. Standart Marble istekleri en fazla 1.600 credits kullanır. marble-1.1-plus en fazla 3.100 credits kullanır.

Kapsam

Bu yönetim endpointleri TokenLab sahipliğindeki medya varlıklarını ve tamamlanan world kayıtlarını kapsar. TokenLab hâlâ marble-1.0-draft üretimini veya bağımsız pano/depth araçlarını açmaz.