Worlds

Listar mundos

Lista los mundos World Labs Marble completados creados a través de TokenLab

POST
/v1/worlds/list

Lista los mundos Marble completados en el Workspace actual.

Utilice GET /v1/tasks/{id} para tareas de generación pendientes o fallidas. Esta lista devuelve los mundos completados que TokenLab ha indexado después de la generación.

Cuerpo de la solicitud

page_sizeintegerpredeterminado: 20

Número de mundos a devolver, del 1 al 100.

page_tokenstring

Token de paginación de la respuesta anterior. Trátelo como un valor opaco.

statusstring

Filtro opcional: SUCCEEDED, PENDING, RUNNING o FAILED. Este endpoint lista mundos completados; los otros tres valores devuelven una lista vacía. Consulte las tareas de generación para comprobar su progreso.

modelstring

Filtro de modelo opcional. También coincide con mundos creados con un modelo que ya no se ofrece.

tagsarray

Filtro de etiquetas opcional. Un mundo coincide cuando tiene al menos una de las etiquetas.

is_publicboolean

Filtro de visibilidad opcional.

created_afterstring

Solo devuelve mundos creados en o después de esta marca de tiempo ISO 8601, por ejemplo 2026-10-01T00:00:00Z.

created_beforestring

Solo devuelve mundos creados antes de esta marca de tiempo ISO 8601.

sort_bystringpredeterminado: created_at

Ordenar por created_at o updated_at.

sort_orderstringpredeterminado: desc

Dirección de ordenación: asc o desc.

Respuesta

worldsarray

Array de registros de mundos, cada uno con world_id y, cuando esté disponible, display_name, world_marble_url, model, tags, created_at y updated_at.

next_page_tokenstring | null

Token para la página siguiente, o null.

Solicitud

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

Autorización

BearerAuth
AuthorizationBearer <token>

Autenticación con API Key. Cree o gestione API keys en Dashboard > API > API Keys.

Ubicación: header

Cuerpo de la solicitud

application/json

Respuesta

application/json

application/json