3D

الحصول على حالة النموذج ثلاثي الأبعاد

استرجاع حالة ونتيجة مهمة إنشاء نموذج ثلاثي الأبعاد

GET
/v1/tasks/{id}

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)

idstringpathمطلوب

معرف مهمة الإنشاء ثلاثي الأبعاد.

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

يتم إرجاع الحقول التي تصف النتائج، والأخطاء، والطوابع الزمنية، والنموذج عند توفرها للمهمة.

idstring

معرف المهمة.

task_idstring

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

poll_urlstring

رابط الحالة لهذه المهمة. قم بعمل استطلاع (poll) لـ GET /v1/tasks/{id} باستخدام id.

statusstring

حالة المهمة: pending (قيد الانتظار)، processing (قيد المعالجة)، completed (مكتملة)، failed (فاشلة)، أو timeout (انتهت المهلة). المهمة الفاشلة لا تزال تُرجع HTTP 200.

progressinteger

قيمة تقدم اختيارية. يتم إرجاعها فقط عند توفر قيمة تقدم حقيقية؛ استخدم status لتحديد الاكتمال.

model_urlstring

رابط لتنزيل ملف النموذج ثلاثي الأبعاد (عند اكتماله). رابط TokenLab لنتائج الوسائط يظل صالحاً لمدة 30 يوماً.

glb_urlstring

رابط لتنزيل النموذج بتنسيق GLB (عند توفره).

fbx_urlstring

رابط لتنزيل النموذج بتنسيق FBX (عند توفره).

errorstring | object

رسالة الخطأ (عند الفشل).

error_detailsobject

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

media_retentionobject

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

الطلب

curl "https://api.tokenlab.sh/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" \
  -H "Authorization: Bearer sk-your-api-key"

الاستجابة

Response (Completed)
{
  "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
AuthorizationBearer <token>

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

الموضع: header

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

id*string

معرف المهمة غير المتزامنة الذي يتم إرجاعه بواسطة id / task_id، أو المضمن في poll_url

الاستجابة

application/json

application/json

application/json

application/json

application/json

application/json

application/json