跳轉到主要內容
列出透過 TokenLab 建立的已完成 World Labs Marble 世界。結果依你的組織隔離；TokenLab 不會暴露共享上游帳號的完整列表。 待處理或失敗的生成任務請使用 /v1/worlds/generations/{id}。此列表只返回生成完成後已由 TokenLab 索引的世界。

​
請求體

​
page_size
integer
預設值:"20"
返回的 world 數量，範圍 1 到 100。
​
page_token
string
上一頁回應返回的分頁 token。
​
status
string
可選狀態篩選。TokenLab 對 SUCCEEDED 返回已完成 worlds；其他狀態屬於生成任務端點。
​
model
string
可選 Marble 模型篩選。
​
tags
array
可選標籤篩選。
​
is_public
boolean
可選可見性篩選。
​
created_after
string
只返回晚於該時間建立的 worlds。
​
created_before
string
只返回早於該時間建立的 worlds。
​
sort_by
string
預設值:"created_at"
依 created_at 或 updated_at 排序。
​
sort_order
string
預設值:"desc"
排序方向：asc 或 desc。

​
回應

​
worlds
array
World 記錄陣列。
​
next_page_token
string
下一頁 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"}'