Ana içeriğe atla
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

​
model
string
varsayılan:"marble-1.0"
Kullanılacak Marble modeli: marble-1.0, marble-1.1 veya marble-1.1-plus.
​
prompt
string
Yalnızca metin üretimi için ya da görüntü/video girişleriyle rehber olarak kullanılacak metin promptu.
​
world_prompt
object
Gelişmiş çağrılar için native World Labs world_prompt nesnesi. Desteklenen prompt türleri text, image, multi-image ve video.
​
image
string
Base64 veya data URL görüntü promptu.
​
image_url
string
Görüntü URL promptu.
​
images
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.
​
video_url
string
Video URL promptu.
​
is_pano
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.
​
seed
integer
0 ile 4294967295 arasında isteğe bağlı seed.
​
display_name
string
Upstream dünya için isteğe bağlı görünen ad, en fazla 64 karakter.
​
tags
array
İsteğe bağlı upstream etiketler. En fazla 10 etiket, her biri en fazla 32 karakter.
​
permission
object
İsteğe bağlı World Labs permission nesnesi.

​
Yanıt

​
id
string
Polling için genel görev IDsi.
​
task_id
string
Asenkron görev tanımlayıcı aliası.
​
operation_id
string
Upstream World Labs operation IDsi.
​
poll_url
string
Bu görev için tercih edilen polling URLsi.
​
status
string
Görev durumu: pending, processing, completed veya failed.
​
world_marble_url
string
Tamamlandığında oluşturulan Marble dünya URLsi.
​
glb_url
string
Varsa collider mesh GLB URLsi.
​
pano_url
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. 
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": "Gün batımında dar sokakları ve sıcak ışıkları olan sakin bir sahil kasabası"
  }'