الانتقال إلى المحتوى الرئيسي
قم بالاستعلام (Poll) عن نقطة النهاية هذه للتحقق من حالة مهمة إنشاء نموذج 3D الخاص بك.
إذا تضمنت استجابة الإنشاء poll_url، فامنح الأفضلية لهذا الرابط الدقيق عند إجراء polling. يجب التعامل مع id وtask_id على أنهما هوية المهمة غير المتزامنة نفسها.إذا لم تعد المهمة موجودة أو لم يعد بالإمكان حلّها عبر عقد المهام غير المتزامنة العامة، يعيد AI Sonar القيمة async_task_not_found مع الرسالة Task not found or no longer available.

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

​
id
string
مطلوب
معرف مهمة إنشاء نموذج 3D.

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

​
id
string
معرف المهمة.
​
task_id
string
الاسم البديل لمعرّف المهمة غير المتزامنة عندما يكون متاحًا.
​
status
string
حالة المهمة: pending أو processing أو completed أو failed.
​
progress
integer
نسبة التقدم (0-100).
​
model_url
string
رابط (URL) لتحميل ملف نموذج 3D (عند الاكتمال).
​
glb_url
string
رابط (URL) لتحميل النموذج بتنسيق GLB (عند توفره).
​
fbx_url
string
رابط (URL) لتحميل النموذج بتنسيق FBX (عند توفره).
​
error
string
رسالة الخطأ (عند الفشل).
curl "https://api.aisonar.dev/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"
}