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
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)
20Số lượng world cần trả về, từ 1 đến 100.
Token phân trang từ response trước đó. Hãy xem giá trị này là opaque.
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.
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.
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.
Bộ lọc chế độ hiển thị tùy chọn.
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.
Chỉ trả về các world được tạo trước mốc thời gian ISO 8601 này.
created_atSắp xếp theo created_at hoặc updated_at.
descChiều sắp xếp: asc hoặc desc.
Phản hồi
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.
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 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