TokenLab

Worlds

列出 Worlds

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

POST
/v1/worlds/list

列出透過 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