Skip to main content
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

string
default:"marble-1.0"
Model Marble yang digunakan: marble-1.0, marble-1.1, atau marble-1.1-plus.
string
Prompt teks untuk generasi teks saja atau sebagai panduan dengan input gambar/video.
object
Objek native World Labs world_prompt untuk pemanggil tingkat lanjut. Tipe prompt yang didukung adalah text, image, multi-image, dan video.
string
Prompt gambar Base64 atau data URL.
string
Prompt URL gambar.
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.
string
Prompt URL video.
boolean | string
Untuk input gambar, set true untuk panorama yang sudah ada, false untuk gambar tunggal normal, atau auto.
integer
Seed opsional dari 0 sampai 4294967295.
string
Nama tampilan opsional untuk world yang dibuat, hingga 64 karakter.
array
Tag World Labs opsional. Hingga 10 tag, masing-masing hingga 32 karakter.
object
Objek permission World Labs opsional.

Respons

string
ID tugas publik untuk polling.
string
Alias identifier tugas asinkron.
string
ID operasi World Labs.
string
URL polling yang disarankan untuk tugas ini.
string
Status tugas: pending, processing, completed, atau failed.
string
URL dunia Marble yang dihasilkan saat selesai.
string
URL GLB collider mesh jika tersedia.
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.