Worlds
Dünyaları Listele
TokenLab aracılığıyla oluşturulan tamamlanmış World Labs Marble dünyalarını listeler
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
20Döndürülecek dünya sayısı (1 ile 100 arasında).
Önceki yanıttan alınan sayfalama token'ı. Opak bir değer olarak ele alın.
İ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.
İsteğe bağlı model filtresi. Artık sunulmayan bir modelle oluşturulmuş dünyalarla da eşleşir.
İsteğe bağlı etiket filtresi. Bir dünya, etiketlerden en az birine sahip olduğunda eşleşir.
İsteğe bağlı görünürlük filtresi.
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.
Yalnızca bu ISO 8601 zaman damgasından önce oluşturulan dünyaları döndürür.
created_atcreated_at veya updated_at değerine göre sıralayın.
descSıralama yönü: asc veya desc.
Yanıt
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.
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 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