Worlds
列出 Worlds
列出透過 TokenLab 建立的已完成 World Labs Marble 世界
列出透過 TokenLab 建立的已完成 World Labs Marble 世界。結果依你的組織隔離;TokenLab 不會暴露共享上游帳號的完整列表。
待處理或失敗的生成任務請使用 /v1/worlds/generations/{id}。此列表只返回生成完成後已由 TokenLab 索引的世界。
請求體
page_sizeinteger預設值:
20返回的 world 數量,範圍 1 到 100。
page_tokenstring
上一頁回應返回的分頁 token。
statusstring
可選值為 SUCCEEDED、PENDING、RUNNING 或 FAILED。此端點列出已完成的 World,後三種值回傳空列表;進度請查詢生成任務端點。
modelstring
可選 Marble 模型篩選。
tagsarray
可選標籤篩選。
is_publicboolean
可選可見性篩選。
created_afterstring
只返回晚於該時間建立的 worlds。
created_beforestring
只返回早於該時間建立的 worlds。
sort_bystring預設值:
created_at依 created_at 或 updated_at 排序。
sort_orderstring預設值:
desc排序方向:asc 或 desc。
回應
worldsarray
World 記錄陣列。
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