Worlds

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

استرجاع حالة ونتيجة مهمة إنشاء عالم World Labs Marble

GET
/v1/worlds/generations/{id}

قم بإجراء استعلام (Poll) لهذا الـ endpoint للتحقق من حالة مهمة إنشاء World Labs Marble. إذا كانت استجابة الإنشاء تتضمن poll_url، فمن الأفضل استدعاء ذلك الـ URL تحديداً.

قد تُرجع المهمة العامة منتهية الصلاحية أو غير المتاحة رمز الخطأ 404 async_task_not_found. إذا تعذر إثبات ملكية المهمة لمفتاح الـ API الحالي، فستكون الاستجابة 403 task_not_owned.

معاملات المسار (Path Parameters)

idstringpathمطلوب

معرف مهمة إنشاء العالم.

الاستجابة (Response)

يُعد كل من id و status مطلوبين فقط في استجابة الحالة الناجحة. يتم إرجاع أسماء المهام المستعارة (aliases)، ومعرفات العمليات، وأصول العالم، والتعليقات التوضيحية، والتكلفة، وسلسلة error عند توفرها. لا تضمن المهمة المكتملة وجود كل روابط الأصول (asset URLs).

idstring

معرف المهمة العام.

task_idstring

الاسم المستعار لمعرف المهمة غير المتزامنة (Async task).

operation_idstring

معرف عملية World Labs.

statusstring

حالة المهمة: pending، processing، completed، failed، أو timeout.

world_idstring

معرف عالم World Labs عند اكتمال المهمة.

world_marble_urlstring

رابط عالم Marble الذي تم إنشاؤه عند اكتمال المهمة.

model_urlstring

اسم مستعار لرابط العالم/النموذج الأساسي الذي تم إنشاؤه.

glb_urlstring

رابط ملف GLB الخاص بشبكة التصادم (Collider mesh) عند توفره.

pano_urlstring

رابط صورة البانوراما عند توفرها.

thumbnail_urlstring

رابط الصورة المصغرة عند توفرها.

captionstring

تعليق توضيحي للعالم الذي تم إنشاؤه.

costobject

تفاصيل تكلفة الإنشاء عند توفرها، بما في ذلك total_credits. تحقق من سجلات الاستخدام الخاصة بك لمعرفة المبلغ المفوتر.

errorstring

رسالة الخطأ في حال فشل المهمة.

الطلب

curl --fail-with-body "https://api.tokenlab.sh/v1/worlds/generations/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" \
  -H "Authorization: Bearer sk-your-api-key"
{  "id": "string",  "task_id": "string",  "operation_id": "string",  "status": "pending",  "world_id": "string",  "world_marble_url": "string",  "model_url": "string",  "glb_url": "string",  "pano_url": "string",  "thumbnail_url": "string",  "caption": "string",  "cost": {},  "error": "string",  "error_details": {    "projection_version": 0,    "status": 400,    "message": "string",    "type": "string",    "code": "string",    "param": "string",    "retryable": true,    "upstream": {      "source": "string",      "code": "string",      "message": "string",      "param": "string"    }  }}

التفويض

BearerAuth
AuthorizationBearer <token>

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

الموضع: header

معاملات المسار

id*string

معرف مهمة توليد العالم.

الاستجابة

application/json

application/json

application/json