Worlds

Listar Worlds

Lista Worlds de World Labs Marble completados creados mediante TokenLab

POST
/v1/worlds/list

Lista los World Labs Marble worlds completados creados mediante TokenLab. Los resultados se limitan a tu organización e incluyen solo recursos creados mediante TokenLab.

Usa /v1/worlds/generations/{id} para tareas pendientes o fallidas. Esta lista devuelve solo Worlds completados que TokenLab indexó después de la generación.

Cuerpo de la solicitud

page_sizeintegerpredeterminado: 20

Cantidad de worlds a devolver, de 1 a 100.

page_tokenstring

Token de paginación de la respuesta anterior.

statusstring

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

modelstring

Filtro opcional de modelo Marble.

tagsarray

Filtro opcional de etiquetas.

is_publicboolean

Filtro opcional de visibilidad.

created_afterstring

Solo devolver worlds creados después de esta marca de tiempo.

created_beforestring

Solo devolver worlds creados antes de esta marca de tiempo.

sort_bystringpredeterminado: created_at

Ordenar por created_at o updated_at.

sort_orderstringpredeterminado: desc

Dirección de orden: asc o desc.

Respuesta

worldsarray

Array de registros world.

next_page_tokenstring | null

Token de 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