Worlds
الحصول على حالة العالم
استرجاع حالة ونتائج مهمة إنشاء عالم World Labs Marble
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)
معرف مهمة إنشاء العالم.
الاستجابة (Response)
فقط id و status مطلوبان في استجابة الحالة الناجحة. يتم إرجاع أسماء المهام المستعارة (aliases)، ومعرفات العمليات، وأصول العالم، والتعليقات التوضيحية عند توفرها. لا تضمن المهمة المكتملة وجود كل رابط أصل (asset URL). لا تزال المهمة الفاشلة تُرجع HTTP 200: اقرأ status و error و error_details.
يفتح world_marble_url عارض World Labs التفاعلي. ملفات النتائج مثل glb_url و pano_url و thumbnail_url هي روابط TokenLab؛ تكون فارغة أو غير موجودة حتى تكتمل المهمة.
معرف المهمة العام.
الاسم المستعار لمعرف المهمة غير المتزامنة.
معرف عملية World Labs.
حالة المهمة: pending أو processing أو completed أو failed أو timeout.
معرف عالم World Labs عند اكتماله.
رابط عالم Marble الذي تم إنشاؤه عند اكتماله.
اسم مستعار لرابط العالم/النموذج الأساسي الذي تم إنشاؤه.
رابط GLB لشبكة التصادم (Collider mesh) عند توفره. رابط وسائط TokenLab يظل صالحاً لمدة 30 يوماً.
رابط صورة البانوراما عند توفرها. رابط وسائط TokenLab يظل صالحاً لمدة 30 يوماً.
رابط الصورة المصغرة عند توفرها. رابط وسائط TokenLab يظل صالحاً لمدة 30 يوماً.
تعليق توضيحي للعالم الذي تم إنشاؤه.
رسالة الخطأ عند فشل المهمة.
تفاصيل الفشل عند فشل المهمة: status و message و type و code و retryable و param عند وجود خطأ في حقل الطلب.
حالة حفظ روابط وسائط 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 مصادقة مفتاح API. قم بإنشاء أو إدارة مفاتيح API في Dashboard > API > API Keys.
الموضع: header
معاملات المسار
معرف مهمة توليد العالم.
الاستجابة
application/json
application/json
application/json