Worlds

Listar Worlds

Lista Worlds World Labs Marble concluídos criados via TokenLab

POST
/v1/worlds/list

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

page_sizeintegerpadrão: 20

Quantidade de worlds retornados, de 1 a 100.

page_tokenstring

Token de paginação da resposta anterior.

statusstring

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.

modelstring

Filtro opcional de modelo Marble.

tagsarray

Filtro opcional de tags.

is_publicboolean

Filtro opcional de visibilidade.

created_afterstring

Retornar apenas worlds criados após esse timestamp.

created_beforestring

Retornar apenas worlds criados antes desse timestamp.

sort_bystringpadrão: created_at

Ordenar por created_at ou updated_at.

sort_orderstringpadrão: desc

Direção da ordenação: asc ou desc.

Resposta

worldsarray

Array de registros world.

next_page_tokenstring | null

Token da próxima página ou null.

Requisição

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"}

Autorização

BearerAuth
AuthorizationBearer <token>

Autenticação por Chave de API. Crie ou gerencie chaves de API em Dashboard > API > API Keys.

Local: header

Corpo da requisição

application/json

Resposta

application/json

application/json