TokenLab

Worlds

Liệt kê Worlds

Liệt kê các World Labs Marble world đã hoàn tất tạo qua TokenLab

POST
/v1/worlds/list

Liệt kê các World Labs Marble worlds đã hoàn tất được tạo qua TokenLab. Kết quả được giới hạn trong tổ chức của bạn và chỉ bao gồm resource được tạo qua TokenLab.

Dùng /v1/worlds/generations/{id} cho các tác vụ đang chờ hoặc thất bại. Danh sách này chỉ trả về world đã hoàn tất mà TokenLab đã lập chỉ mục sau khi tạo.

Thân yêu cầu

page_sizeintegermặc định: 20

Số world trả về, từ 1 đến 100.

page_tokenstring

Token phân trang từ phản hồi trước.

statusstring

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

modelstring

Bộ lọc model Marble tùy chọn.

tagsarray

Bộ lọc tag tùy chọn.

is_publicboolean

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

created_afterstring

Chỉ trả world được tạo sau thời điểm này.

created_beforestring

Chỉ trả world được tạo trước thời điểm 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 bản ghi world.

next_page_tokenstring | null

Token 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