TokenLab

Worlds

Lister les mondes

Liste les mondes Marble World Labs terminés créés via TokenLab

POST
/v1/worlds/list

Liste les Marble Worlds terminés dans l'espace de travail actuel.

Utilisez GET /v1/tasks/{id} pour les tâches de génération en attente ou ayant échoué. Cette liste renvoie les mondes terminés que TokenLab a indexés après leur génération.

Corps de la requête

page_sizeintegerpar défaut: 20

Nombre de mondes à renvoyer, de 1 à 100.

page_tokenstring

Jeton de pagination provenant de la réponse précédente. Traitez-le comme une valeur opaque.

statusstring

Filtre optionnel : SUCCEEDED, PENDING, RUNNING ou FAILED. Ce point de terminaison liste les mondes terminés ; les trois autres valeurs renvoient une liste vide. Interrogez les tâches de génération pour connaître leur progression.

modelstring

Filtre de modèle optionnel. Il correspond également aux mondes créés avec un modèle qui n'est plus proposé.

tagsarray

Filtre de balises optionnel. Un monde correspond s'il possède au moins l'une des balises.

is_publicboolean

Filtre de visibilité optionnel.

created_afterstring

Renvoie uniquement les mondes créés à partir de ce timestamp ISO 8601, par exemple 2026-10-01T00:00:00Z.

created_beforestring

Renvoie uniquement les mondes créés avant ce timestamp ISO 8601.

sort_bystringpar défaut: created_at

Trier par created_at ou updated_at.

sort_orderstringpar défaut: desc

Direction du tri : asc ou desc.

Réponse

worldsarray

Tableau d'enregistrements de mondes, chacun avec world_id et, lorsqu'ils sont disponibles, display_name, world_marble_url, model, tags, created_at et updated_at.

next_page_tokenstring | null

Jeton pour la page suivante, ou null.

Requête

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

Autorisation

BearerAuth
AuthorizationBearer <token>

Authentification par clé API. Créez ou gérez vos clés API dans Dashboard > API > API Keys.

Emplacement: header

Corps de la requête

application/json

Réponse

application/json

application/json