TokenLab

Worlds

列出世界

列出透過 TokenLab 建立的已完成 World Labs Marble 世界

POST
/v1/worlds/list

列出當前 Workspace 中已完成的 Marble 世界。

若要查詢處理中或失敗的生成任務,請使用 GET /v1/tasks/{id}。此列表僅返回 TokenLab 在生成後已建立索引的已完成世界。

請求主體

page_sizeinteger預設值: 20

要返回的世界數量,範圍為 1 到 100。

page_tokenstring

來自先前回應的分頁 token。請將其視為不透明值。

statusstring

可選篩選條件:SUCCEEDED、PENDING、RUNNING 或 FAILED。此端點列出已完成的世界;其他三個值將返回空列表。請查詢生成任務以獲取其進度。

modelstring

可選模型篩選條件。它也適用於使用不再提供的模型所建立的世界。

tagsarray

可選標籤篩選條件。當世界包含至少其中一個標籤時即符合條件。

is_publicboolean

可選可見性篩選條件。

created_afterstring

僅返回在此 ISO 8601 時間戳記或之後建立的世界,例如 2026-10-01T00:00:00Z。

created_beforestring

僅返回在此 ISO 8601 時間戳記之前建立的世界。

sort_bystring預設值: created_at

依據 created_at 或 updated_at 排序。

sort_orderstring預設值: desc

排序方向:asc 或 desc。

回應

worldsarray

世界記錄陣列,每筆記錄包含 world_id,以及在可用時包含 display_name、world_marble_url、model、tags、created_at 和 updated_at。

next_page_tokenstring | null

下一頁的 token,或為 null。

請求

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"}

授權

BearerAuth
AuthorizationBearer <token>

API Key 驗證。請在 Dashboard > API > API Keys 建立或管理 API 金鑰。

位置: header

請求主體

application/json

回應

application/json

application/json