TokenLab
الحصول على مفتاح API
التوثيقمرجع APIالتكاملات

Worlds

عرض Worlds

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

POST
/v1/worlds/list

يعرض World Labs Marble worlds المكتملة التي تم إنشاؤها عبر TokenLab. النتائج مقيدة بمؤسستك وتشمل فقط الموارد المنشأة عبر TokenLab.

استخدم /v1/worlds/generations/{id} للمهام قيد الانتظار أو الفاشلة. هذه القائمة تعيد فقط العوالم المكتملة التي فهرسها TokenLab بعد الإنشاء.

جسم الطلب

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

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

page_tokenstring

رمز الصفحة من الاستجابة السابقة.

statusstring

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

modelstring

مرشح اختياري لنموذج Marble.

tagsarray

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

is_publicboolean

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

created_afterstring

إرجاع worlds المنشأة بعد هذا الوقت فقط.

created_beforestring

إرجاع worlds المنشأة قبل هذا الوقت فقط.

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

الترتيب حسب created_at أو updated_at.

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

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

الاستجابة

worldsarray

مصفوفة سجلات world.

next_page_tokenstring | null

رمز الصفحة التالية أو 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

الحصول على حالة العالم

السابق

جلب World

التالي