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
Daftar Worlds
Menampilkan World Labs Marble world selesai yang dibuat melalui TokenLab
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"
}
}Menampilkan World Labs Marble worlds yang selesai dibuat melalui TokenLab. Hasil dibatasi untuk organisasi Anda dan hanya mencakup resource yang dibuat melalui TokenLab.
Gunakan
/v1/worlds/generations/{id} untuk tugas yang pending atau gagal. Daftar ini hanya mengembalikan world selesai yang telah diindeks TokenLab setelah generasi.
Body permintaan
integer
default:"20"
Jumlah world yang dikembalikan, 1 sampai 100.
string
Token paginasi dari respons sebelumnya.
string
Filter opsional:
SUCCEEDED, PENDING, RUNNING, atau FAILED. Endpoint ini mencantumkan world yang selesai; tiga nilai lainnya mengembalikan daftar kosong. Ambil tugas generasi untuk melihat kemajuannya.string
Filter model Marble opsional.
array
Filter tag opsional.
boolean
Filter visibilitas opsional.
string
Hanya kembalikan world yang dibuat setelah timestamp ini.
string
Hanya kembalikan world yang dibuat sebelum timestamp ini.
string
default:"created_at"
Urutkan berdasarkan
created_at atau updated_at.string
default:"desc"
Arah urutan:
asc atau desc.Respons
array
Array catatan world.
string | null
Token halaman berikutnya atau
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);
Otorisasi
Autentikasi API Key. Buat atau kelola API key di Dashboard > API > API Keys.
Body
application/json
Rentang yang diperlukan:
1 <= x <= 100Opsi yang tersedia:
SUCCEEDED, PENDING, FAILED, RUNNING Opsi yang tersedia:
marble-1.0, marble-1.1, marble-1.1-plus, marble-1.0-draft Opsi yang tersedia:
created_at, updated_at Ekstensi TokenLab untuk urutan menaik atau menurun.
Opsi yang tersedia:
asc, desc