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"
}'
import requests
response = requests.post(
"https://api.tokenlab.sh/v1/worlds/generations",
headers={"Authorization": "Bearer sk-your-api-key"},
json={
"model": "marble-1.1",
"prompt": "Kota pesisir yang tenang saat matahari terbenam dengan gang sempit dan lampu hangat",
},
)
task = response.json()
print(task["id"], task["poll_url"])
const response = await fetch('https://api.tokenlab.sh/v1/worlds/generations', {
method: 'POST',
headers: {
Authorization: 'Bearer sk-your-api-key',
'Content-Type': 'application/json'
},
body: JSON.stringify({
model: 'marble-1.1',
prompt: 'Kota pesisir yang tenang saat matahari terbenam dengan gang sempit dan lampu hangat'
})
});
const task = await response.json();
console.log(task.id, task.poll_url);
{
"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": {}
}Worlds
Buat World
Membuat tugas pembuatan dunia World Labs Marble
POST
/
v1
/
worlds
/
generations
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"
}'
import requests
response = requests.post(
"https://api.tokenlab.sh/v1/worlds/generations",
headers={"Authorization": "Bearer sk-your-api-key"},
json={
"model": "marble-1.1",
"prompt": "Kota pesisir yang tenang saat matahari terbenam dengan gang sempit dan lampu hangat",
},
)
task = response.json()
print(task["id"], task["poll_url"])
const response = await fetch('https://api.tokenlab.sh/v1/worlds/generations', {
method: 'POST',
headers: {
Authorization: 'Bearer sk-your-api-key',
'Content-Type': 'application/json'
},
body: JSON.stringify({
model: 'marble-1.1',
prompt: 'Kota pesisir yang tenang saat matahari terbenam dengan gang sempit dan lampu hangat'
})
});
const task = await response.json();
console.log(task.id, task.poll_url);
{
"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": {}
}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
string
default:"marble-1.0"
Pilih model Marble yang tersedia saat ini melalui Models API.
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
Pengaturan visibilitas dan akses opsional:
public, allow_id_access, allowed_readers, dan allowed_writers. public: true meminta world yang dapat dilihat publik.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
Lihat Pricing API untuk tarif saat ini. Jumlah tagihan tercantum dalam catatan penggunaan; nilaicost.total_credits yang dikembalikan adalah penggunaan generasi, bukan jumlah uang.
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"
}'
import requests
response = requests.post(
"https://api.tokenlab.sh/v1/worlds/generations",
headers={"Authorization": "Bearer sk-your-api-key"},
json={
"model": "marble-1.1",
"prompt": "Kota pesisir yang tenang saat matahari terbenam dengan gang sempit dan lampu hangat",
},
)
task = response.json()
print(task["id"], task["poll_url"])
const response = await fetch('https://api.tokenlab.sh/v1/worlds/generations', {
method: 'POST',
headers: {
Authorization: 'Bearer sk-your-api-key',
'Content-Type': 'application/json'
},
body: JSON.stringify({
model: 'marble-1.1',
prompt: 'Kota pesisir yang tenang saat matahari terbenam dengan gang sempit dan lampu hangat'
})
});
const task = await response.json();
console.log(task.id, task.poll_url);
Otorisasi
Autentikasi API Key. Buat atau kelola API key di Dashboard > API > API Keys.
Header
Kebijakan Delivery per-request. Menggantikan default API key dan Workspace. Secara otomatis mencoba TokenLab Verified terlebih dahulu dan dapat beralih satu kali ke Official saja sebelum output, penerimaan upstream, atau pembuatan resource persisten.
Opsi yang tersedia:
auto, verified, official Body
application/json
- Option 1
- Option 2
- Option 3
- Option 4
- Option 5
- Option 6
Objek world_prompt World Labs asli untuk pemanggil tingkat lanjut. Tipe prompt yang didukung adalah text, image, multi-image, dan video. Referensi konten dapat menggunakan source=media_asset dengan media_asset_id yang disiapkan oleh /v1/worlds/media-assets/prepare-upload.
Model Marble yang akan digunakan. Default ke marble-1.0 untuk mencocokkan default kompatibilitas World Labs saat ini jika model dihilangkan.
Opsi yang tersedia:
marble-1.0, marble-1.1, marble-1.1-plus Prompt teks yang digunakan untuk pembuatan dunia berbasis teks atau gambar/video terpandu.
Nama tampilan opsional untuk dunia yang dihasilkan, hingga 64 karakter.
Maximum string length:
64Prompt gambar Base64 atau URL data.
Prompt URL gambar.
Pintasan prompt multi-gambar. Berikan hingga 4 gambar. Gunakan world_prompt.reconstruct_images=true asli untuk hingga 8 gambar.
Maximum array length:
4Prompt URL video.
Apakah prompt gambar adalah panorama yang ada. Gunakan true untuk input pano, false untuk input gambar tunggal, atau auto.
Seed opsional dari 0 hingga 4294967295.
Rentang yang diperlukan:
0 <= x <= 4294967295Tag World Labs opsional. Berikan hingga 10 tag, masing-masing hingga 32 karakter.
Maximum array length:
10Maximum string length:
32Objek izin World Labs opsional.
Pengidentifikasi pengguna akhir.