Saltar al contenido principal
Lista Worlds de World Labs Marble completados creados mediante TokenLab. Los resultados están limitados a tu organización; TokenLab no expone la lista global de la cuenta upstream compartida. 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_size
integer
predeterminado:"20"
Cantidad de worlds a devolver, de 1 a 100.
​
page_token
string
Token de paginación de la respuesta anterior.
​
status
string
Filtro opcional de estado. TokenLab devuelve worlds completados para SUCCEEDED; otros estados pertenecen al endpoint de tarea de generación.
​
model
string
Filtro opcional de modelo Marble.
​
tags
array
Filtro opcional de etiquetas.
​
is_public
boolean
Filtro opcional de visibilidad.
​
created_after
string
Solo devolver worlds creados después de esta marca de tiempo.
​
created_before
string
Solo devolver worlds creados antes de esta marca de tiempo.
​
sort_by
string
predeterminado:"created_at"
Ordenar por created_at o updated_at.
​
sort_order
string
predeterminado:"desc"
Dirección de orden: asc o desc.

​
Respuesta

​
worlds
array
Array de registros world.
​
next_page_token
string
Token de la página siguiente o null.
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"}'