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"}'
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"])
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);
{
"worlds": [
{
"world_id": "<string>",
"display_name": "<string>",
"world_marble_url": "<string>",
"assets": {},
"created_at": "2023-11-07T05:31:56Z",
"model": "<string>",
"permission": {},
"tags": [
"<string>"
],
"updated_at": "2023-11-07T05:31:56Z",
"world_prompt": {}
}
],
"next_page_token": "<string>"
}{
"error": {
"message": "Invalid API key provided",
"type": "invalid_api_key"
}
}Worlds
World 목록
TokenLab에서 만든 완료된 World Labs Marble world를 나열합니다
POST
/
v1
/
worlds
/
list
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"}'
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"])
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);
{
"worlds": [
{
"world_id": "<string>",
"display_name": "<string>",
"world_marble_url": "<string>",
"assets": {},
"created_at": "2023-11-07T05:31:56Z",
"model": "<string>",
"permission": {},
"tags": [
"<string>"
],
"updated_at": "2023-11-07T05:31:56Z",
"world_prompt": {}
}
],
"next_page_token": "<string>"
}{
"error": {
"message": "Invalid API key provided",
"type": "invalid_api_key"
}
}TokenLab에서 만든 완료된 World Labs Marble world를 나열합니다. 결과는 조직별로 격리되며 공유 상위 계정의 전체 목록은 노출하지 않습니다.
대기 중이거나 실패한 생성 작업은
/v1/worlds/generations/{id}를 사용하세요. 이 목록은 생성 후 TokenLab이 색인한 완료 world만 반환합니다.
요청 본문
integer
기본값:"20"
반환할 world 수, 1~100.
string
이전 응답의 페이지 토큰.
string
선택 값은
SUCCEEDED, PENDING, RUNNING, FAILED입니다. 이 엔드포인트는 완료된 월드를 나열하며 나머지 세 값에는 빈 목록을 반환합니다. 진행 상황은 생성 작업에서 조회하세요.string
선택 Marble 모델 필터.
array
선택 태그 필터.
boolean
선택 공개 여부 필터.
string
이 시각 이후 생성된 world만 반환합니다.
string
이 시각 이전 생성된 world만 반환합니다.
string
기본값:"created_at"
created_at 또는 updated_at 기준 정렬.string
기본값:"desc"
정렬 방향:
asc 또는 desc.응답
array
World 레코드 배열.
string | 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"}'
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"])
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);
인증
API 키 인증입니다. Dashboard > API > API Keys에서 API 키를 생성하거나 관리하십시오.
본문
application/json
필수 범위:
1 <= x <= 100사용 가능한 옵션:
SUCCEEDED, PENDING, FAILED, RUNNING 사용 가능한 옵션:
marble-1.0, marble-1.1, marble-1.1-plus, marble-1.0-draft 사용 가능한 옵션:
created_at, updated_at 오름차순 또는 내림차순 정렬을 위한 TokenLab 확장입니다.
사용 가능한 옵션:
asc, desc