Worlds
Lister les mondes
Liste les mondes Marble World Labs terminés créés via TokenLab
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
20Nombre de mondes à renvoyer, de 1 à 100.
Jeton de pagination provenant de la réponse précédente. Traitez-le comme une valeur opaque.
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.
Filtre de modèle optionnel. Il correspond également aux mondes créés avec un modèle qui n'est plus proposé.
Filtre de balises optionnel. Un monde correspond s'il possède au moins l'une des balises.
Filtre de visibilité optionnel.
Renvoie uniquement les mondes créés à partir de ce timestamp ISO 8601, par exemple 2026-10-01T00:00:00Z.
Renvoie uniquement les mondes créés avant ce timestamp ISO 8601.
created_atTrier par created_at ou updated_at.
descDirection du tri : asc ou desc.
Réponse
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.
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 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