메인 콘텐츠로 건너뛰기
TokenLab에서 만든 완료된 World Labs Marble world를 나열합니다. 결과는 조직별로 격리되며 공유 상위 계정의 전체 목록은 노출하지 않습니다. 대기 중이거나 실패한 생성 작업은 /v1/worlds/generations/{id}를 사용하세요. 이 목록은 생성 후 TokenLab이 색인한 완료 world만 반환합니다.

​
요청 본문

​
page_size
integer
기본값:"20"
반환할 world 수, 1~100.
​
page_token
string
이전 응답의 페이지 토큰.
​
status
string
선택 상태 필터. TokenLab은 SUCCEEDED에 대해 완료된 world를 반환하며 다른 상태는 생성 작업 엔드포인트에서 확인합니다.
​
model
string
선택 Marble 모델 필터.
​
tags
array
선택 태그 필터.
​
is_public
boolean
선택 공개 여부 필터.
​
created_after
string
이 시각 이후 생성된 world만 반환합니다.
​
created_before
string
이 시각 이전 생성된 world만 반환합니다.
​
sort_by
string
기본값:"created_at"
created_at 또는 updated_at 기준 정렬.
​
sort_order
string
기본값:"desc"
정렬 방향: asc 또는 desc.

​
응답

​
worlds
array
World 레코드 배열.
​
next_page_token
string
다음 페이지 토큰 또는 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"}'