> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tokenlab.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# Liệt kê Worlds

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

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

<ParamField body="page_size" type="integer" default="20">
  Số world trả về, từ 1 đến 100.
</ParamField>

<ParamField body="page_token" type="string">
  Token phân trang từ phản hồi trước.
</ParamField>

<ParamField body="status" type="string">
  Bộ lọc trạng thái tùy chọn. TokenLab trả world hoàn tất cho `SUCCEEDED`; trạng thái khác thuộc endpoint tác vụ tạo.
</ParamField>

<ParamField body="model" type="string">
  Bộ lọc model Marble tùy chọn.
</ParamField>

<ParamField body="tags" type="array">
  Bộ lọc tag tùy chọn.
</ParamField>

<ParamField body="is_public" type="boolean">
  Bộ lọc hiển thị tùy chọn.
</ParamField>

<ParamField body="created_after" type="string">
  Chỉ trả world được tạo sau thời điểm này.
</ParamField>

<ParamField body="created_before" type="string">
  Chỉ trả world được tạo trước thời điểm này.
</ParamField>

<ParamField body="sort_by" type="string" default="created_at">
  Sắp xếp theo `created_at` hoặc `updated_at`.
</ParamField>

<ParamField body="sort_order" type="string" default="desc">
  Chiều sắp xếp: `asc` hoặc `desc`.
</ParamField>

## Phản hồi

<ResponseField name="worlds" type="array">
  Mảng bản ghi world.
</ResponseField>

<ResponseField name="next_page_token" type="string">
  Token trang tiếp theo hoặc `null`.
</ResponseField>

<RequestExample>
  ```bash cURL theme={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"}'
  ```

  ```python Python theme={null}
  import requests

  response = requests.post(
      "https://api.tokenlab.sh/v1/worlds/list",
      headers={"Authorization": "Bearer sk-your-api-key"},
      json={"page_size": 20, "status": "SUCCEEDED", "model": "marble-1.1"},
  )
  print(response.json()["worlds"])
  ```

  ```javascript JavaScript theme={null}
  const response = await fetch('https://api.tokenlab.sh/v1/worlds/list', {
    method: 'POST',
    headers: {
      Authorization: 'Bearer sk-your-api-key',
      'Content-Type': 'application/json'
    },
    body: JSON.stringify({ page_size: 20, status: 'SUCCEEDED', model: 'marble-1.1' })
  });
  console.log((await response.json()).worlds);
  ```
</RequestExample>