Worlds
列出世界
列出透過 TokenLab 建立的已完成 World Labs Marble 世界
列出當前 Workspace 中已完成的 Marble 世界。
若要查詢處理中或失敗的生成任務,請使用 GET /v1/tasks/{id}。此列表僅返回 TokenLab 在生成後已建立索引的已完成世界。
請求主體
20要返回的世界數量,範圍為 1 到 100。
來自先前回應的分頁 token。請將其視為不透明值。
可選篩選條件:SUCCEEDED、PENDING、RUNNING 或 FAILED。此端點列出已完成的世界;其他三個值將返回空列表。請查詢生成任務以獲取其進度。
可選模型篩選條件。它也適用於使用不再提供的模型所建立的世界。
可選標籤篩選條件。當世界包含至少其中一個標籤時即符合條件。
可選可見性篩選條件。
僅返回在此 ISO 8601 時間戳記或之後建立的世界,例如 2026-10-01T00:00:00Z。
僅返回在此 ISO 8601 時間戳記之前建立的世界。
created_at依據 created_at 或 updated_at 排序。
desc排序方向:asc 或 desc。
回應
世界記錄陣列,每筆記錄包含 world_id,以及在可用時包含 display_name、world_marble_url、model、tags、created_at 和 updated_at。
下一頁的 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 API Key 驗證。請在 Dashboard > API > API Keys 建立或管理 API 金鑰。
位置: header
請求主體
application/json
回應
application/json
application/json