TokenLab

Worlds

Lister les Worlds

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

POST
/v1/worlds/list

Liste les World Labs Marble worlds terminés créés via TokenLab. Les résultats sont limités à votre organisation et n’incluent que les ressources créées via TokenLab.

Utilisez /v1/worlds/generations/{id} pour les tâches en attente ou échouées. Cette liste renvoie uniquement les Worlds terminés que TokenLab a indexés après génération.

Corps de requête

page_sizeintegerpar défaut: 20

Nombre de worlds à renvoyer, de 1 à 100.

page_tokenstring

Token de pagination de la réponse précédente.

statusstring

Filtre facultatif : SUCCEEDED, PENDING, RUNNING ou FAILED. Ce point de terminaison liste les mondes terminés ; les trois autres valeurs renvoient une liste vide. Consultez la tâche de génération pour sa progression.

modelstring

Filtre optionnel sur le modèle Marble.

tagsarray

Filtre optionnel sur les tags.

is_publicboolean

Filtre optionnel de visibilité.

created_afterstring

Ne renvoyer que les worlds créés après cet horodatage.

created_beforestring

Ne renvoyer que les worlds créés avant cet horodatage.

sort_bystringpar défaut: created_at

Trier par created_at ou updated_at.

sort_orderstringpar défaut: desc

Ordre de tri: asc ou desc.

Réponse

worldsarray

Tableau d’enregistrements world.

next_page_tokenstring | null

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