Worlds
Welten auflisten
Listet abgeschlossene World Labs Marble-Welten auf, die über TokenLab erstellt wurden
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
20Anzahl der zurückzugebenden Welten, von 1 bis 100.
Paginierungs-Token aus der vorherigen Antwort. Behandeln Sie ihn als opaken Wert.
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.
Optionaler Modellfilter. Berücksichtigt auch Welten, die mit einem nicht mehr angebotenen Modell erstellt wurden.
Optionaler Tag-Filter. Eine Welt stimmt überein, wenn sie mindestens einen der Tags aufweist.
Optionaler Sichtbarkeitsfilter.
Gibt nur Welten zurück, die an oder nach diesem ISO-8601-Zeitstempel erstellt wurden, zum Beispiel 2026-10-01T00:00:00Z.
Gibt nur Welten zurück, die vor diesem ISO-8601-Zeitstempel erstellt wurden.
created_atSortieren nach created_at oder updated_at.
descSortierrichtung: asc oder desc.
Antwort
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.
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 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