Worlds

Worlds auflisten

Listet abgeschlossene World Labs Marble Worlds aus TokenLab auf

POST
/v1/worlds/list

Liste abgeschlossene World Labs Marble Worlds auf, die über TokenLab erstellt wurden. Ergebnisse sind auf deine Organisation begrenzt; TokenLab veröffentlicht nicht die kontoübergreifende Upstream-Liste.

Nutze /v1/worlds/generations/{id} für ausstehende oder fehlgeschlagene Generierungsaufgaben. Diese Liste enthält nur abgeschlossene Worlds, die TokenLab nach der Generierung indexiert hat.

Anfragekörper

page_sizeintegerStandard: 20

Anzahl der zurückgegebenen Worlds, 1 bis 100.

page_tokenstring

Paginierungs-Token aus der vorherigen Antwort.

statusstring

Optionaler Filter: SUCCEEDED, PENDING, RUNNING oder FAILED. Dieser Endpunkt listet abgeschlossene Worlds auf; die anderen drei Werte liefern eine leere Liste. Den Fortschritt finden Sie beim Generierungstask.

modelstring

Optionaler Marble-Modellfilter.

tagsarray

Optionaler Tag-Filter.

is_publicboolean

Optionaler Sichtbarkeitsfilter.

created_afterstring

Gibt nur Worlds zurück, die nach diesem Zeitpunkt erstellt wurden.

created_beforestring

Gibt nur Worlds zurück, die vor diesem Zeitpunkt erstellt wurden.

sort_bystringStandard: created_at

Sortieren nach created_at oder updated_at.

sort_orderstringStandard: desc

Sortierrichtung: asc oder desc.

Antwort

worldsarray

Array von World-Datensätzen.

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