Worlds

عرض قائمة العوالم

يعرض عوالم World Labs Marble المكتملة التي تم إنشاؤها عبر TokenLab

POST
/v1/worlds/list

عرض عوالم Marble المكتملة في Workspace الحالي.

استخدم GET /v1/tasks/{id} لمهام التوليد المعلقة أو الفاشلة. تُرجع هذه القائمة العوالم المكتملة التي قام TokenLab بفهرستها بعد التوليد.

جسم الطلب

page_sizeintegerالافتراضي: 20

عدد العوالم المراد إرجاعها، من 1 إلى 100.

page_tokenstring

token ترقيم الصفحات من الاستجابة السابقة. تعامل معه كقيمة مبهمة (opaque).

statusstring

مرشح اختياري: SUCCEEDED، أو PENDING، أو RUNNING، أو FAILED. تعرض نقطة النهاية هذه العوالم المكتملة؛ وتُرجع القيم الثلاث الأخرى قائمة فارغة. استعلم عن مهام التوليد لمعرفة مدى تقدمها.

modelstring

مرشح اختياري للنموذج. يطابق أيضًا العوالم التي تم إنشاؤها باستخدام نموذج لم يعد متوفرًا.

tagsarray

مرشح اختياري للوسوم. يتطابق العالم عندما يحتوي على وسم واحد على الأقل من هذه الوسوم.

is_publicboolean

مرشح اختياري لمستوى الرؤية.

created_afterstring

إرجاع العوالم التي تم إنشاؤها في هذا الطابع الزمني ISO 8601 أو بعده فقط، على سبيل المثال 2026-10-01T00:00:00Z.

created_beforestring

إرجاع العوالم التي تم إنشاؤها قبل هذا الطابع الزمني ISO 8601 فقط.

sort_bystringالافتراضي: created_at

الفرز حسب created_at أو updated_at.

sort_orderstringالافتراضي: desc

اتجاه الترتيب: asc أو desc.

الاستجابة

worldsarray

مصفوفة من سجلات العوالم، يحتوي كل منها على world_id، وعند توفرها، display_name، وworld_marble_url، وmodel، وtags، وcreated_at، وupdated_at.

next_page_tokenstring | null

token للصفحة التالية، أو null.

الطلب

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

التفويض

BearerAuth
AuthorizationBearer <token>

مصادقة مفتاح API. قم بإنشاء أو إدارة مفاتيح API في Dashboard > API > API Keys.

الموضع: header

جسم الطلب

application/json

الاستجابة

application/json

application/json