Worlds
월드 목록 조회
TokenLab을 통해 생성된 완료된 World Labs Marble 월드 목록을 조회합니다
현재 Workspace에서 완료된 Marble 월드 목록을 조회합니다.
대기 중이거나 실패한 생성 작업에는 GET /v1/tasks/{id}를 사용하세요. 이 목록은 생성 후 TokenLab에서 색인화한 완료된 월드들을 반환합니다.
요청 본문
20반환할 월드 수로, 1에서 100 사이의 값입니다.
이전 응답에서 받은 페이지네이션 토큰입니다. 불투명한 값(opaque value)으로 처리하세요.
선택적 필터: SUCCEEDED, PENDING, RUNNING 또는 FAILED. 이 엔드포인트는 완료된 월드 목록을 나열하며, 나머지 세 값은 빈 목록을 반환합니다. 진행 상황을 확인하려면 생성 작업을 조회하세요.
선택적 모델 필터입니다. 더 이상 제공되지 않는 모델로 제작된 월드와도 일치합니다.
선택적 태그 필터입니다. 태그 중 하나 이상을 포함하는 월드가 일치합니다.
선택적 공개 여부 필터입니다.
이 ISO 8601 타임스탬프(예: 2026-10-01T00:00:00Z) 이후 또는 해당 시점에 생성된 월드만 반환합니다.
이 ISO 8601 타임스탬프 이전에 생성된 월드만 반환합니다.
created_atcreated_at 또는 updated_at 기준으로 정렬합니다.
desc정렬 방향: asc 또는 desc.
응답
월드 레코드 배열입니다. 각 레코드는 world_id를 포함하며, 제공 가능한 경우 display_name, world_marble_url, model, tags, created_at 및 updated_at을 포함합니다.
다음 페이지를 위한 토큰 또는 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 API 키 인증입니다. Dashboard > API > API Keys에서 API 키를 생성하거나 관리하십시오.
위치: header
요청 본문
application/json
응답
application/json
application/json