Worlds
Listar mundos
Lista mundos Marble da World Labs concluídos criados por meio do TokenLab
Lista mundos Marble concluídos no Workspace atual.
Use GET /v1/tasks/{id} para tarefas de geração pendentes ou com falha. Esta lista retorna mundos concluídos que o TokenLab indexou após a geração.
Corpo da requisição
20Número de mundos a serem retornados, de 1 a 100.
Token de paginação da resposta anterior. Trate-o como um valor opaco.
Filtro opcional: SUCCEEDED, PENDING, RUNNING ou FAILED. Este endpoint lista mundos concluídos; os outros três valores retornam uma lista vazia. Consulte as tarefas de geração para acompanhar o progresso delas.
Filtro de modelo opcional. Também corresponde a mundos criados com um modelo que não é mais oferecido.
Filtro de tags opcional. Um mundo corresponde quando possui pelo menos uma das tags.
Filtro de visibilidade opcional.
Retorna apenas mundos criados neste ou após este timestamp ISO 8601, por exemplo 2026-10-01T00:00:00Z.
Retorna apenas mundos criados antes deste timestamp ISO 8601.
created_atOrdenar por created_at ou updated_at.
descDireção da ordenação: asc ou desc.
Resposta
Array de registros de mundos, cada um com world_id e, quando disponível, display_name, world_marble_url, model, tags, created_at e updated_at.
Token para a 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 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