3D
الحصول على حالة نموذج 3D
يسترجع حالة ونتيجة مهمة إنشاء نموذج 3D
قم بالاستعلام (Poll) عن نقطة النهاية هذه للتحقق من حالة مهمة إنشاء نموذج 3D الخاص بك.
إذا تضمنت استجابة الإنشاء poll_url، فامنح الأفضلية لهذا الرابط الدقيق عند إجراء polling. يجب التعامل مع id وtask_id على أنهما هوية المهمة غير المتزامنة نفسها.
قد تعيد المهمة العامة المنتهية أو غير المتاحة 404 async_task_not_found. إذا تعذر إثبات ملكية المهمة لمفتاح API الحالي، تكون الاستجابة 403 task_not_owned.
معلمات المسار
معرف مهمة إنشاء نموذج 3D.
الاستجابة (Response)
تُعاد حقول النتائج والأخطاء والطوابع الزمنية والنموذج عند توفرها للمهمة.
معرف المهمة.
الاسم البديل لمعرّف المهمة غير المتزامنة عندما يكون متاحًا.
رابط polling المفضّل عندما يكون متاحًا.
حالة المهمة: pending أو processing أو completed أو failed.
قيمة تقدم اختيارية. لا تُعاد إلا عند توفر قيمة تقدم حقيقية؛ استخدم status لتحديد اكتمال المهمة.
رابط (URL) لتحميل ملف نموذج 3D (عند الاكتمال).
رابط (URL) لتحميل النموذج بتنسيق GLB (عند توفره).
رابط (URL) لتحميل النموذج بتنسيق FBX (عند توفره).
رسالة الخطأ (عند الفشل).
الطلب
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://cdn.tripo3d.ai/abc123.glb",
"glb_url": "https://cdn.tripo3d.ai/abc123.glb",
"fbx_url": "https://cdn.tripo3d.ai/abc123.fbx"
}التفويض
BearerAuth مصادقة مفتاح API. قم بإنشاء أو إدارة مفاتيح API في Dashboard > API > API Keys.
الموضع: header
معاملات المسار
معرف المهمة غير المتزامنة الذي يتم إرجاعه بواسطة id / task_id، أو المضمن في poll_url
الاستجابة
application/json
application/json
application/json
application/json