TokenLab

Worlds

월드 목록 조회

TokenLab을 통해 생성된 완료된 World Labs Marble 월드 목록을 조회합니다

POST
/v1/worlds/list

현재 Workspace에서 완료된 Marble 월드 목록을 조회합니다.

대기 중이거나 실패한 생성 작업에는 GET /v1/tasks/{id}를 사용하세요. 이 목록은 생성 후 TokenLab에서 색인화한 완료된 월드들을 반환합니다.

요청 본문

page_sizeinteger기본값: 20

반환할 월드 수로, 1에서 100 사이의 값입니다.

page_tokenstring

이전 응답에서 받은 페이지네이션 토큰입니다. 불투명한 값(opaque value)으로 처리하세요.

statusstring

선택적 필터: SUCCEEDED, PENDING, RUNNING 또는 FAILED. 이 엔드포인트는 완료된 월드 목록을 나열하며, 나머지 세 값은 빈 목록을 반환합니다. 진행 상황을 확인하려면 생성 작업을 조회하세요.

modelstring

선택적 모델 필터입니다. 더 이상 제공되지 않는 모델로 제작된 월드와도 일치합니다.

tagsarray

선택적 태그 필터입니다. 태그 중 하나 이상을 포함하는 월드가 일치합니다.

is_publicboolean

선택적 공개 여부 필터입니다.

created_afterstring

이 ISO 8601 타임스탬프(예: 2026-10-01T00:00:00Z) 이후 또는 해당 시점에 생성된 월드만 반환합니다.

created_beforestring

이 ISO 8601 타임스탬프 이전에 생성된 월드만 반환합니다.

sort_bystring기본값: created_at

created_at 또는 updated_at 기준으로 정렬합니다.

sort_orderstring기본값: desc

정렬 방향: asc 또는 desc.

응답

worldsarray

월드 레코드 배열입니다. 각 레코드는 world_id를 포함하며, 제공 가능한 경우 display_name, world_marble_url, model, tags, created_at 및 updated_at을 포함합니다.

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