3D
الحصول على حالة النموذج ثلاثي الأبعاد
استرجاع حالة ونتيجة مهمة إنشاء نموذج ثلاثي الأبعاد
GET /v1/3d/generations/{id} هي نقطة نهاية للتوافق. تظل مدعومة لعمليات التكامل الحالية. عمليات التكامل الجديدة تستخدم GET /v1/tasks/{id}؛ راجع الحصول على حالة المهمة.
قم باستدعاء GET /v1/tasks/{id} للتحقق من حالة مهمة إنشاء النموذج ثلاثي الأبعاد الخاصة بك.
id و task_id يحددان نفس المهمة.
قد تُرجع المهمة العامة منتهية الصلاحية أو غير المتاحة 404 async_task_not_found. إذا تعذر تحديد ملكية المهمة لمفتاح API الحالي، تكون الاستجابة 403 task_not_owned.
معاملات المسار (Path Parameters)
معرف مهمة الإنشاء ثلاثي الأبعاد.
الاستجابة (Response)
يتم إرجاع الحقول التي تصف النتائج، والأخطاء، والطوابع الزمنية، والنموذج عند توفرها للمهمة.
معرف المهمة.
اسم مستعار لمعرف المهمة غير المتزامنة عند توفره.
رابط الحالة لهذه المهمة. قم بعمل استطلاع (poll) لـ GET /v1/tasks/{id} باستخدام id.
حالة المهمة: pending (قيد الانتظار)، processing (قيد المعالجة)، completed (مكتملة)، failed (فاشلة)، أو timeout (انتهت المهلة). المهمة الفاشلة لا تزال تُرجع HTTP 200.
قيمة تقدم اختيارية. يتم إرجاعها فقط عند توفر قيمة تقدم حقيقية؛ استخدم status لتحديد الاكتمال.
رابط لتنزيل ملف النموذج ثلاثي الأبعاد (عند اكتماله). رابط TokenLab لنتائج الوسائط يظل صالحاً لمدة 30 يوماً.
رابط لتنزيل النموذج بتنسيق GLB (عند توفره).
رابط لتنزيل النموذج بتنسيق FBX (عند توفره).
رسالة الخطأ (عند الفشل).
تفاصيل الفشل عند فشل المهمة: status، message، type، code، retryable، و param عند وجود خطأ في حقل الطلب.
حالة حفظ روابط النتائج: days و items[] مع url، و kind، و status، و expires_at. قد يكون غائباً؛ الروابط لا تزال تعمل. راجع الاحتفاظ بالبيانات.
الطلب
curl "https://api.tokenlab.sh/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" \
-H "Authorization: Bearer sk-your-api-key"الاستجابة
{
"id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"task_id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"poll_url": "/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"status": "completed",
"model_url": "https://api.tokenlab.sh/v1/media-results/5e2a7c90-1d4b-4f8e-a3c6-8b9d0e1f2a47.glb?token=…",
"glb_url": "https://api.tokenlab.sh/v1/media-results/5e2a7c90-1d4b-4f8e-a3c6-8b9d0e1f2a47.glb?token=…",
"fbx_url": "https://api.tokenlab.sh/v1/media-results/8d1b3f6a-9c2e-4a5d-b7e0-2f4c6a8e0d15.fbx?token=…",
"media_retention": {
"days": 30,
"items": [
{
"url": "https://api.tokenlab.sh/v1/media-results/5e2a7c90-1d4b-4f8e-a3c6-8b9d0e1f2a47.glb?token=…",
"kind": "3d",
"content_type": "model/gltf-binary",
"status": "saved",
"expires_at": "2024-02-22T08:54:20.000Z"
},
{
"url": "https://api.tokenlab.sh/v1/media-results/8d1b3f6a-9c2e-4a5d-b7e0-2f4c6a8e0d15.fbx?token=…",
"kind": "3d",
"content_type": "application/octet-stream",
"status": "saved",
"expires_at": "2024-02-22T08:54:20.000Z"
}
]
}
}التفويض
BearerAuth مصادقة مفتاح API. قم بإنشاء أو إدارة مفاتيح API في Dashboard > API > API Keys.
الموضع: header
معاملات المسار
معرف المهمة غير المتزامنة الذي يتم إرجاعه بواسطة id / task_id، أو المضمن في poll_url
الاستجابة
application/json
application/json
application/json
application/json
application/json
application/json
application/json