Worlds

Daftar World

Mencantumkan World Labs Marble world yang telah selesai dibuat melalui TokenLab

POST
/v1/worlds/list

Mencantumkan Marble World yang telah selesai di Workspace saat ini.

Gunakan GET /v1/tasks/{id} untuk tugas pembuatan yang berstatus pending atau gagal. Daftar ini mengembalikan world yang telah selesai dan diindeks oleh TokenLab setelah proses pembuatan.

Body Permintaan

page_sizeintegerbawaan: 20

Jumlah world yang dikembalikan, dari 1 hingga 100.

page_tokenstring

Token paginasi dari respons sebelumnya. Perlakukan sebagai nilai opaque.

statusstring

Filter opsional: SUCCEEDED, PENDING, RUNNING, atau FAILED. Endpoint ini mencantumkan world yang telah selesai; tiga nilai lainnya mengembalikan daftar kosong. Kueri tugas pembuatan untuk melihat progresnya.

modelstring

Filter model opsional. Ini juga mencocokkan world yang dibuat dengan model yang sudah tidak ditawarkan lagi.

tagsarray

Filter tag opsional. World cocok jika memiliki setidaknya salah satu dari tag tersebut.

is_publicboolean

Filter visibilitas opsional.

created_afterstring

Hanya mengembalikan world yang dibuat pada atau setelah stempel waktu ISO 8601 ini, misalnya 2026-10-01T00:00:00Z.

created_beforestring

Hanya mengembalikan world yang dibuat sebelum stempel waktu ISO 8601 ini.

sort_bystringbawaan: created_at

Urutkan berdasarkan created_at atau updated_at.

sort_orderstringbawaan: desc

Arah pengurutan: asc atau desc.

Respons

worldsarray

Array rekaman world, masing-masing berisi world_id dan, jika tersedia, display_name, world_marble_url, model, tags, created_at, dan updated_at.

next_page_tokenstring | null

Token untuk halaman berikutnya, atau null.

Permintaan

curl -X POST "https://api.tokenlab.sh/v1/worlds/list" \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{"page_size": 20, "status": "SUCCEEDED", "model": "marble-1.1"}'
{  "worlds": [    {      "display_name": "string",      "world_id": "string",      "world_marble_url": "http://example.com",      "assets": {},      "created_at": "2019-08-24T14:15:22Z",      "model": "string",      "permission": {},      "tags": [        "string"      ],      "updated_at": "2019-08-24T14:15:22Z",      "world_prompt": {}    }  ],  "next_page_token": "string"}

Otorisasi

BearerAuth
AuthorizationBearer <token>

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

Lokasi: header

Body permintaan

application/json

Respons

application/json

application/json