Worlds
عرض قائمة العوالم
يعرض عوالم World Labs Marble المكتملة التي تم إنشاؤها عبر TokenLab
عرض عوالم Marble المكتملة في Workspace الحالي.
استخدم GET /v1/tasks/{id} لمهام التوليد المعلقة أو الفاشلة. تُرجع هذه القائمة العوالم المكتملة التي قام TokenLab بفهرستها بعد التوليد.
جسم الطلب
20عدد العوالم المراد إرجاعها، من 1 إلى 100.
token ترقيم الصفحات من الاستجابة السابقة. تعامل معه كقيمة مبهمة (opaque).
مرشح اختياري: SUCCEEDED، أو PENDING، أو RUNNING، أو FAILED. تعرض نقطة النهاية هذه العوالم المكتملة؛ وتُرجع القيم الثلاث الأخرى قائمة فارغة. استعلم عن مهام التوليد لمعرفة مدى تقدمها.
مرشح اختياري للنموذج. يطابق أيضًا العوالم التي تم إنشاؤها باستخدام نموذج لم يعد متوفرًا.
مرشح اختياري للوسوم. يتطابق العالم عندما يحتوي على وسم واحد على الأقل من هذه الوسوم.
مرشح اختياري لمستوى الرؤية.
إرجاع العوالم التي تم إنشاؤها في هذا الطابع الزمني ISO 8601 أو بعده فقط، على سبيل المثال 2026-10-01T00:00:00Z.
إرجاع العوالم التي تم إنشاؤها قبل هذا الطابع الزمني ISO 8601 فقط.
created_atالفرز حسب created_at أو updated_at.
descاتجاه الترتيب: asc أو desc.
الاستجابة
مصفوفة من سجلات العوالم، يحتوي كل منها على world_id، وعند توفرها، display_name، وworld_marble_url، وmodel، وtags، وcreated_at، وupdated_at.
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 مصادقة مفتاح API. قم بإنشاء أو إدارة مفاتيح API في Dashboard > API > API Keys.
الموضع: header
جسم الطلب
application/json
الاستجابة
application/json
application/json