Worlds

Daftar Worlds

Menampilkan World Labs Marble world selesai yang dibuat melalui TokenLab

POST
/v1/worlds/list

Menampilkan World Labs Marble worlds yang selesai dibuat melalui TokenLab. Hasil dibatasi untuk organisasi Anda dan hanya mencakup resource yang dibuat melalui TokenLab.

Gunakan /v1/worlds/generations/{id} untuk tugas yang pending atau gagal. Daftar ini hanya mengembalikan world selesai yang telah diindeks TokenLab setelah generasi.

Body permintaan

page_sizeintegerbawaan: 20

Jumlah world yang dikembalikan, 1 sampai 100.

page_tokenstring

Token paginasi dari respons sebelumnya.

statusstring

Filter opsional: SUCCEEDED, PENDING, RUNNING, atau FAILED. Endpoint ini mencantumkan world yang selesai; tiga nilai lainnya mengembalikan daftar kosong. Ambil tugas generasi untuk melihat kemajuannya.

modelstring

Filter model Marble opsional.

tagsarray

Filter tag opsional.

is_publicboolean

Filter visibilitas opsional.

created_afterstring

Hanya kembalikan world yang dibuat setelah timestamp ini.

created_beforestring

Hanya kembalikan world yang dibuat sebelum timestamp ini.

sort_bystringbawaan: created_at

Urutkan berdasarkan created_at atau updated_at.

sort_orderstringbawaan: desc

Arah urutan: asc atau desc.

Respons

worldsarray

Array catatan world.

next_page_tokenstring | null

Token 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