Worlds
الحصول على حالة العالم
استرجاع حالة ونتيجة مهمة إنشاء عالم World Labs Marble
قم بإجراء استعلام (Poll) لهذا الـ endpoint للتحقق من حالة مهمة إنشاء World Labs Marble. إذا كانت استجابة الإنشاء تتضمن poll_url، فمن الأفضل استدعاء ذلك الـ URL تحديداً.
قد تُرجع المهمة العامة منتهية الصلاحية أو غير المتاحة رمز الخطأ 404 async_task_not_found. إذا تعذر إثبات ملكية المهمة لمفتاح الـ API الحالي، فستكون الاستجابة 403 task_not_owned.
معاملات المسار (Path Parameters)
معرف مهمة إنشاء العالم.
الاستجابة (Response)
يُعد كل من id و status مطلوبين فقط في استجابة الحالة الناجحة. يتم إرجاع أسماء المهام المستعارة (aliases)، ومعرفات العمليات، وأصول العالم، والتعليقات التوضيحية، والتكلفة، وسلسلة error عند توفرها. لا تضمن المهمة المكتملة وجود كل روابط الأصول (asset URLs).
معرف المهمة العام.
الاسم المستعار لمعرف المهمة غير المتزامنة (Async task).
معرف عملية World Labs.
حالة المهمة: pending، processing، completed، failed، أو timeout.
معرف عالم World Labs عند اكتمال المهمة.
رابط عالم Marble الذي تم إنشاؤه عند اكتمال المهمة.
اسم مستعار لرابط العالم/النموذج الأساسي الذي تم إنشاؤه.
رابط ملف GLB الخاص بشبكة التصادم (Collider mesh) عند توفره.
رابط صورة البانوراما عند توفرها.
رابط الصورة المصغرة عند توفرها.
تعليق توضيحي للعالم الذي تم إنشاؤه.
تفاصيل تكلفة الإنشاء عند توفرها، بما في ذلك total_credits. تحقق من سجلات الاستخدام الخاصة بك لمعرفة المبلغ المفوتر.
رسالة الخطأ في حال فشل المهمة.
الطلب
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 مصادقة مفتاح API. قم بإنشاء أو إدارة مفاتيح API في Dashboard > API > API Keys.
الموضع: header
معاملات المسار
معرف مهمة توليد العالم.
الاستجابة
application/json
application/json
application/json