TokenLab

Worlds

Danh sách Worlds

Liệt kê các Marble world đã hoàn thành của World Labs được tạo thông qua TokenLab

POST
/v1/worlds/list

Liệt kê các Marble World đã hoàn thành trong Workspace hiện tại.

Sử dụng GET /v1/tasks/{id} cho các tác vụ khởi tạo đang chờ xử lý hoặc thất bại. Danh sách này trả về các world đã hoàn thành mà TokenLab đã lập chỉ mục sau khi tạo.

Phần thân yêu cầu (Request Body)

page_sizeintegermặc định: 20

Số lượng world cần trả về, từ 1 đến 100.

page_tokenstring

Token phân trang từ response trước đó. Hãy xem giá trị này là opaque.

statusstring

Bộ lọc tùy chọn: SUCCEEDED, PENDING, RUNNING hoặc FAILED. Endpoint này liệt kê các world đã hoàn thành; ba giá trị còn lại sẽ trả về một danh sách rỗng. Truy vấn các tác vụ khởi tạo để biết tiến trình của chúng.

modelstring

Bộ lọc model tùy chọn. Bộ lọc này cũng khớp với các world được tạo bằng model không còn được cung cấp nữa.

tagsarray

Bộ lọc tag tùy chọn. Một world sẽ khớp nếu có ít nhất một trong các tag.

is_publicboolean

Bộ lọc chế độ hiển thị tùy chọn.

created_afterstring

Chỉ trả về các world được tạo vào hoặc sau mốc thời gian ISO 8601 này, ví dụ 2026-10-01T00:00:00Z.

created_beforestring

Chỉ trả về các world được tạo trước mốc thời gian ISO 8601 này.

sort_bystringmặc định: created_at

Sắp xếp theo created_at hoặc updated_at.

sort_orderstringmặc định: desc

Chiều sắp xếp: asc hoặc desc.

Phản hồi

worldsarray

Mảng các bản ghi world, mỗi bản ghi bao gồm world_id và khi có sẵn: display_name, world_marble_url, model, tags, created_at, và updated_at.

next_page_tokenstring | null

Token cho trang tiếp theo, hoặc null.

Yêu cầu

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

Xác thực

BearerAuth
AuthorizationBearer <token>

Xác thực bằng Khóa API. Tạo hoặc quản lý khóa API trong Dashboard > API > API Keys.

Vị trí: header

Nội dung yêu cầu

application/json

Phản hồi

application/json

application/json