Skip to main content

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

string
مطلوب
معرّف المهمة المُعاد من طلب إنشاء الفيديو. اعتبر id و task_id نفس الهوية غير المتزامنة.
إذا أعادت استجابة الإنشاء قيمة poll_url، فاستدعِ ذلك العنوان بالضبط. عندما يشير إلى /v1/tasks/{id}، اعتبره نقطة النهاية الأساسية الثابتة لحالة المهمة.إذا لم تعد المهمة موجودة أو لم يعد بالإمكان حلها عبر عقد المهمة غير المتزامنة العام، فتعيد TokenLab القيمة async_task_not_found مع الرسالة Task not found or no longer available.

الاستجابة

string
المعرّف الرسمي للمهمة غير المتزامنة.
string
الاسم المستعار لمعرّف المهمة غير المتزامنة.
string
عنوان URL المفضل للاستعلام المتكرر عندما توفر استجابة الإنشاء واحدًا.
string
معرّف معاملة الفوترة في TokenLab عندما تكون التسوية قد اكتملت بالفعل. هذا هو معرّف المعاملة المستخدم في لوحة التحكم / المطابقة، وهو منفصل عن id / task_id غير المتزامن.
string
حالة المهمة: pending, processing, completed, failed.
number
قيمة تقدم اختيارية. لا تُعاد إلا عند توفر قيمة تقدم حقيقية؛ استخدم status لتحديد اكتمال المهمة.
string
عنوان URL للفيديو الناتج (عند الاكتمال).
object
حمولة فيديو مفردة تحتوي على الحقول url, duration, width, و height عندما تتوفر.
array
حمولات فيديو متعددة عندما تعيد مهمة التوليد أكثر من مخرج واحد.
string
رسالة الخطأ (إذا فشلت).
integer
طابع زمني للإنشاء.
integer
طابع زمني لآخر تحديث.
string
النموذج المستخدم للمهمة.

أفضل ممارسات الاستطلاع

  • استعلم كل 5-10 ثوانٍ
  • طبّق آلية تراجع أُسِّي (exponential backoff) للمهام الطويلة
  • حدد مهلة قصوى (مثلاً، 10 دقائق)
  • تعامل مع الحالة failed بشكل ملائم