TokenLab
API anahtarı al
DokümantasyonAPI ReferansıEntegrasyonlar

Worlds

Worlds listele

TokenLab ile oluşturulmuş tamamlanan World Labs Marble world kayıtlarını listeler

POST
/v1/worlds/list

TokenLab ile oluşturulmuş tamamlanan World Labs Marble world kayıtlarını listeleyin. Sonuçlar organizasyonunuzla sınırlıdır; TokenLab paylaşılan upstream hesabının genel listesini açmaz.

Bekleyen veya başarısız üretim görevleri için /v1/worlds/generations/{id} kullanın. Bu liste yalnızca üretimden sonra TokenLab tarafından indekslenen tamamlanmış world kayıtlarını döndürür.

İstek gövdesi

page_sizeintegervarsayılan: 20

Döndürülecek world sayısı, 1 ile 100 arası.

page_tokenstring

Önceki yanıttaki sayfalama tokenı.

statusstring

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

modelstring

İsteğe bağlı Marble model filtresi.

tagsarray

İsteğe bağlı etiket filtresi.

is_publicboolean

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

created_afterstring

Yalnızca bu zamandan sonra oluşturulan world kayıtlarını döndürür.

created_beforestring

Yalnızca bu zamandan önce oluşturulan world kayıtlarını döndürür.

sort_bystringvarsayılan: created_at

created_at veya updated_at ile sırala.

sort_orderstringvarsayılan: desc

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

Yanıt

worldsarray

World kayıtları dizisi.

next_page_tokenstring | null

Sonraki sayfa 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

Dünya Durumunu Al

Önceki

World al

Sonraki