TokenLab
Dapatkan kunci API
DokumentasiReferensi APIIntegrasi

Worlds

Buat World

Membuat tugas pembuatan dunia World Labs Marble

POST
/v1/worlds/generations

Buat dunia 3D yang dapat dijelajahi dengan World Labs Marble. API ini asinkron: respons create mengembalikan identitas tugas dan poll_url untuk memeriksa status.

Pilih model Marble yang tersedia saat ini melalui Models API.

Isi Permintaan

modelstringbawaan: marble-1.0

Pilih model Marble yang tersedia saat ini melalui Models API.

promptstring

Prompt teks untuk generasi teks saja atau sebagai panduan dengan input gambar/video.

world_promptobject

Objek native World Labs world_prompt untuk pemanggil tingkat lanjut. Tipe prompt yang didukung adalah text, image, multi-image, dan video.

imagestring

Prompt gambar Base64 atau data URL.

image_urlstring

Prompt URL gambar.

imagesarray

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_urlstring

Prompt URL video.

is_panoboolean | string

Untuk input gambar, set true untuk panorama yang sudah ada, false untuk gambar tunggal normal, atau auto.

seedinteger

Seed opsional dari 0 sampai 4294967295.

display_namestring

Nama tampilan opsional untuk world yang dibuat, hingga 64 karakter.

tagsarray

Tag World Labs opsional. Hingga 10 tag, masing-masing hingga 32 karakter.

permissionobject

Pengaturan visibilitas dan akses opsional: public, allow_id_access, allowed_readers, dan allowed_writers. public: true meminta world yang dapat dilihat publik.

Respons

idstring

ID tugas publik untuk polling.

task_idstring

Alias identifier tugas asinkron.

operation_idstring

ID operasi World Labs.

poll_urlstring

URL polling yang disarankan untuk tugas ini.

statusstring

Status tugas: pending, processing, completed, atau failed.

world_marble_urlstring

URL dunia Marble yang dihasilkan saat selesai.

glb_urlstring

URL GLB collider mesh jika tersedia.

pano_urlstring

URL gambar panorama jika tersedia.

Harga

Lihat Pricing API untuk tarif saat ini. Jumlah tagihan tercantum dalam catatan penggunaan; nilai cost.total_credits yang dikembalikan adalah penggunaan generasi, bukan jumlah uang.

Permintaan

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"
  }'
{  "id": "string",  "task_id": "string",  "operation_id": "string",  "status": "pending",  "poll_url": "string",  "world_id": "string",  "world_marble_url": "string",  "model_url": "string",  "glb_url": "string",  "pano_url": "string",  "thumbnail_url": "string",  "caption": "string",  "cost": {},  "error": "string",  "error_details": {    "projection_version": 0,    "status": 400,    "message": "string",    "type": "string",    "code": "string",    "param": "string",    "retryable": true,    "upstream": {      "source": "string",      "code": "string",      "message": "string",      "param": "string"    }  }}

Otorisasi

BearerAuth
AuthorizationBearer <token>

Autentikasi API Key. Buat atau kelola API key di Dashboard > API > API Keys.

Lokasi: header

Header

X-TokenLab-Delivery-Policy?string

Kebijakan Pengiriman per-permintaan. Menggantikan default API key dan Workspace. Secara otomatis mencoba TokenLab Verified terlebih dahulu dan dapat beralih satu kali ke Official saja sebelum output, penerimaan permintaan, atau pembuatan sumber daya persisten.

Nilai yang tersedia

  • "auto"
  • "verified"
  • "official"

Body permintaan

application/json

Respons

application/json

application/json

application/json

Ambil aset media

Sebelumnya

Dapatkan Status Dunia

Berikutnya