Worlds

Welten auflisten

Listet abgeschlossene World Labs Marble-Welten auf, die über TokenLab erstellt wurden

POST
/v1/worlds/list

Listet abgeschlossene Marble-Welten im aktuellen Workspace auf.

Verwenden Sie GET /v1/tasks/{id} für ausstehende oder fehlgeschlagene Generierungs-Tasks. Diese Liste gibt abgeschlossene Welten zurück, die TokenLab nach der Generierung indexiert hat.

Request-Body

page_sizeintegerStandard: 20

Anzahl der zurückzugebenden Welten, von 1 bis 100.

page_tokenstring

Paginierungs-Token aus der vorherigen Antwort. Behandeln Sie ihn als opaken Wert.

statusstring

Optionaler Filter: SUCCEEDED, PENDING, RUNNING oder FAILED. Dieser Endpunkt listet abgeschlossene Welten auf; die anderen drei Werte geben eine leere Liste zurück. Fragen Sie Generierungs-Tasks ab, um deren Fortschritt zu ermitteln.

modelstring

Optionaler Modellfilter. Berücksichtigt auch Welten, die mit einem nicht mehr angebotenen Modell erstellt wurden.

tagsarray

Optionaler Tag-Filter. Eine Welt stimmt überein, wenn sie mindestens einen der Tags aufweist.

is_publicboolean

Optionaler Sichtbarkeitsfilter.

created_afterstring

Gibt nur Welten zurück, die an oder nach diesem ISO-8601-Zeitstempel erstellt wurden, zum Beispiel 2026-10-01T00:00:00Z.

created_beforestring

Gibt nur Welten zurück, die vor diesem ISO-8601-Zeitstempel erstellt wurden.

sort_bystringStandard: created_at

Sortieren nach created_at oder updated_at.

sort_orderstringStandard: desc

Sortierrichtung: asc oder desc.

Antwort

worldsarray

Array von Datensätzen der Welten, jeweils mit world_id und, sofern verfügbar, display_name, world_marble_url, model, tags, created_at und updated_at.

next_page_tokenstring | null

Token für die nächste Seite oder null.

Anfrage

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

Autorisierung

BearerAuth
AuthorizationBearer <token>

API-Key-Authentifizierung. Erstellen oder verwalten Sie API-Keys unter Dashboard > API > API Keys.

Ort: header

Anfragekörper

application/json

Antwort

application/json

application/json