Worlds

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

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

GET
/v1/worlds/generations/{id}

GET /v1/worlds/generations/{id} هو نقطة نهاية للتوافق. يظل مدعوماً لعمليات التكامل الحالية. عمليات التكامل الجديدة يجب أن تستخدم GET /v1/tasks/{id} مع نفس id الخاص بالمهمة؛ راجع الحصول على حالة المهمة.

تقوم نقطة النهاية هذه بإرجاع حالة مهمة إنشاء World Labs Marble. استخدم id المهمة من استجابة الإنشاء.

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

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

idstringpathمطلوب

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

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

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

يفتح world_marble_url عارض World Labs التفاعلي. ملفات النتائج مثل glb_url و pano_url و thumbnail_url هي روابط TokenLab؛ تكون فارغة أو غير موجودة حتى تكتمل المهمة.

idstring

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

task_idstring

الاسم المستعار لمعرف المهمة غير المتزامنة.

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) عند توفره. رابط وسائط TokenLab يظل صالحاً لمدة 30 يوماً.

pano_urlstring

رابط صورة البانوراما عند توفرها. رابط وسائط TokenLab يظل صالحاً لمدة 30 يوماً.

thumbnail_urlstring

رابط الصورة المصغرة عند توفرها. رابط وسائط TokenLab يظل صالحاً لمدة 30 يوماً.

captionstring

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

errorstring | object

رسالة الخطأ عند فشل المهمة.

error_detailsobject

تفاصيل الفشل عند فشل المهمة: status و message و type و code و retryable و param عند وجود خطأ في حقل الطلب.

media_retentionobject

حالة حفظ روابط وسائط TokenLab في استجابة مكتملة: days و items[] مع url و kind و status و expires_at. قد تكون غائبة؛ الروابط لا تزال تعمل. راجع الاحتفاظ بالبيانات.

الطلب

curl --fail-with-body "https://api.tokenlab.sh/v1/tasks/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",  "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"    }  },  "media_retention": {    "days": 0,    "items": [      {        "url": "http://example.com",        "kind": "image",        "content_type": "string",        "status": "saving",        "expires_at": "2019-08-24T14:15:22Z"      }    ]  }}

التفويض

BearerAuth
AuthorizationBearer <token>

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

الموضع: header

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

id*string

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

الاستجابة

application/json

application/json

application/json