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
Listar Worlds
Lista Worlds World Labs Marble concluídos criados via 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"
}
}Lista World Labs Marble worlds concluídos criados pela TokenLab. Os resultados são limitados à sua organização e incluem apenas recursos criados pela TokenLab.
Use
/v1/worlds/generations/{id} para tarefas pendentes ou com falha. Esta lista retorna apenas Worlds concluídos que TokenLab indexou após a geração.
Corpo da requisição
integer
padrão:"20"
Quantidade de worlds retornados, de 1 a 100.
string
Token de paginação da resposta anterior.
string
Filtro opcional:
SUCCEEDED, PENDING, RUNNING ou FAILED. Este endpoint lista mundos concluídos; os outros três valores retornam uma lista vazia. Consulte a tarefa de geração para acompanhar o progresso.string
Filtro opcional de modelo Marble.
array
Filtro opcional de tags.
boolean
Filtro opcional de visibilidade.
string
Retornar apenas worlds criados após esse timestamp.
string
Retornar apenas worlds criados antes desse timestamp.
string
padrão:"created_at"
Ordenar por
created_at ou updated_at.string
padrão:"desc"
Direção da ordenação:
asc ou desc.Resposta
array
Array de registros world.
string | null
Token da próxima página ou
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);
Autorizações
Autenticação por Chave de API. Crie ou gerencie chaves de API em Dashboard > API > API Keys.
Corpo
application/json
Intervalo necessário:
1 <= x <= 100Opções disponíveis:
SUCCEEDED, PENDING, FAILED, RUNNING Opções disponíveis:
marble-1.0, marble-1.1, marble-1.1-plus, marble-1.0-draft Opções disponíveis:
created_at, updated_at Extensão do TokenLab para ordem crescente ou decrescente.
Opções disponíveis:
asc, desc