Worlds
Listar mundos
Lista los mundos World Labs Marble completados creados a través de TokenLab
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
20Número de mundos a devolver, del 1 al 100.
Token de paginación de la respuesta anterior. Trátelo como un valor opaco.
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.
Filtro de modelo opcional. También coincide con mundos creados con un modelo que ya no se ofrece.
Filtro de etiquetas opcional. Un mundo coincide cuando tiene al menos una de las etiquetas.
Filtro de visibilidad opcional.
Solo devuelve mundos creados en o después de esta marca de tiempo ISO 8601, por ejemplo 2026-10-01T00:00:00Z.
Solo devuelve mundos creados antes de esta marca de tiempo ISO 8601.
created_atOrdenar por created_at o updated_at.
descDirección de ordenación: asc o desc.
Respuesta
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.
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 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