Langsung ke konten utama
Buat dunia 3D yang dapat dijelajahi dengan World Labs Marble. API ini asinkron: respons create mengembalikan identitas tugas dan poll_url untuk memeriksa status. Model yang didukung adalah marble-1.0, marble-1.1, dan marble-1.1-plus. World Labs mendokumentasikan marble-1.0-draft, tetapi TokenLab belum mengekspos draft generation di endpoint ini.

​
Isi Permintaan

​
model
string
default:"marble-1.0"
Model Marble yang digunakan: marble-1.0, marble-1.1, atau marble-1.1-plus.
​
prompt
string
Prompt teks untuk generasi teks saja atau sebagai panduan dengan input gambar/video.
​
world_prompt
object
Objek native World Labs world_prompt untuk pemanggil tingkat lanjut. Tipe prompt yang didukung adalah text, image, multi-image, dan video.
​
image
string
Prompt gambar Base64 atau data URL.
​
image_url
string
Prompt URL gambar.
​
images
array
Beberapa prompt gambar untuk shortcut multi-image generation. Berikan hingga 4 gambar. Untuk mode rekonstruksi native World Labs, kirim world_prompt.type="multi-image" dengan reconstruct_images: true dan hingga 8 gambar.
​
video_url
string
Prompt URL video.
​
is_pano
boolean | string
Untuk input gambar, set true untuk panorama yang sudah ada, false untuk gambar tunggal normal, atau auto.
​
seed
integer
Seed opsional dari 0 sampai 4294967295.
​
display_name
string
Nama tampilan opsional untuk world upstream, hingga 64 karakter.
​
tags
array
Tag upstream opsional. Hingga 10 tag, masing-masing hingga 32 karakter.
​
permission
object
Objek permission World Labs opsional.

​
Respons

​
id
string
ID tugas publik untuk polling.
​
task_id
string
Alias identifier tugas asinkron.
​
operation_id
string
ID operation World Labs upstream.
​
poll_url
string
URL polling yang disarankan untuk tugas ini.
​
status
string
Status tugas: pending, processing, completed, atau failed.
​
world_marble_url
string
URL dunia Marble yang dihasilkan saat selesai.
​
glb_url
string
URL GLB collider mesh jika tersedia.
​
pano_url
string
URL gambar panorama jika tersedia.

​
Harga

World Labs menagih dalam credits. TokenLab melakukan pre-deduct maksimum sesuai tipe request dan menyelesaikan berdasarkan cost.total_credits dari operation yang selesai jika tersedia. Request Marble standar hingga 1.600 credits. marble-1.1-plus hingga 3.100 credits.

​
Cakupan

Endpoint manajemen ini mencakup aset media milik TokenLab dan world selesai. TokenLab masih belum mengekspos generasi marble-1.0-draft atau alat pano/depth mandiri. 
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": "Kota pesisir yang tenang saat matahari terbenam dengan gang sempit dan lampu hangat"
  }'