Worlds

Dünyaları Listele

TokenLab aracılığıyla oluşturulan tamamlanmış World Labs Marble dünyalarını listeler

POST
/v1/worlds/list

Mevcut Workspace'teki tamamlanmış Marble Dünyalarını listeleyin.

Bekleyen veya başarısız olan üretim görevleri için GET /v1/tasks/{id} kullanın. Bu liste, TokenLab'in üretim sonrasında dizine eklediği tamamlanmış dünyaları döndürür.

İstek Gövdesi

page_sizeintegervarsayılan: 20

Döndürülecek dünya sayısı (1 ile 100 arasında).

page_tokenstring

Önceki yanıttan alınan sayfalama token'ı. Opak bir değer olarak ele alın.

statusstring

İsteğe bağlı filtre: SUCCEEDED, PENDING, RUNNING veya FAILED. Bu uç nokta tamamlanmış dünyaları listeler; diğer üç değer boş bir liste döndürür. İlerlemeleri için üretim görevlerini sorgulayın.

modelstring

İsteğe bağlı model filtresi. Artık sunulmayan bir modelle oluşturulmuş dünyalarla da eşleşir.

tagsarray

İsteğe bağlı etiket filtresi. Bir dünya, etiketlerden en az birine sahip olduğunda eşleşir.

is_publicboolean

İsteğe bağlı görünürlük filtresi.

created_afterstring

Yalnızca bu ISO 8601 zaman damgasında veya sonrasında oluşturulan dünyaları döndürür, örneğin 2026-10-01T00:00:00Z.

created_beforestring

Yalnızca bu ISO 8601 zaman damgasından önce oluşturulan dünyaları döndürür.

sort_bystringvarsayılan: created_at

created_at veya updated_at değerine göre sıralayın.

sort_orderstringvarsayılan: desc

Sıralama yönü: asc veya desc.

Yanıt

worldsarray

Her biri world_id ve mevcut olduğunda display_name, world_marble_url, model, tags, created_at ve updated_at içeren dünya kayıtları dizisi.

next_page_tokenstring | null

Sonraki sayfa için token veya null.

İstek

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

Yetkilendirme

BearerAuth
AuthorizationBearer <token>

API Anahtarı kimlik doğrulaması. API anahtarlarını Dashboard > API > API Keys bölümünden oluşturun veya yönetin.

Konum: header

İstek gövdesi

application/json

Yanıt

application/json

application/json