Worlds
World 목록
TokenLab에서 만든 완료된 World Labs Marble world를 나열합니다
TokenLab에서 만든 완료된 World Labs Marble world를 나열합니다. 결과는 조직별로 격리되며 공유 상위 계정의 전체 목록은 노출하지 않습니다.
대기 중이거나 실패한 생성 작업은 /v1/worlds/generations/{id}를 사용하세요. 이 목록은 생성 후 TokenLab이 색인한 완료 world만 반환합니다.
요청 본문
page_sizeinteger기본값:
20반환할 world 수, 1~100.
page_tokenstring
이전 응답의 페이지 토큰.
statusstring
선택 값은 SUCCEEDED, PENDING, RUNNING, FAILED입니다. 이 엔드포인트는 완료된 월드를 나열하며 나머지 세 값에는 빈 목록을 반환합니다. 진행 상황은 생성 작업에서 조회하세요.
modelstring
선택 Marble 모델 필터.
tagsarray
선택 태그 필터.
is_publicboolean
선택 공개 여부 필터.
created_afterstring
이 시각 이후 생성된 world만 반환합니다.
created_beforestring
이 시각 이전 생성된 world만 반환합니다.
sort_bystring기본값:
created_atcreated_at 또는 updated_at 기준 정렬.
sort_orderstring기본값:
desc정렬 방향: asc 또는 desc.
응답
worldsarray
World 레코드 배열.
next_page_tokenstring | null
다음 페이지 토큰 또는 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"}'{ "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"}인증
BearerAuth AuthorizationBearer <token>
API 키 인증입니다. Dashboard > API > API Keys에서 API 키를 생성하거나 관리하십시오.
위치: header
요청 본문
application/json
응답
application/json
application/json