استخدم polling كنهج أساسي لتوليد الفيديو لأن كل مهمة async تُرجع معرّف مهمة يمكنك الاستعلام عنه. أضف webhooks فقط عندما تدعم نقطة نهاية الفيديو المحددة عناوين URL الخاصة بـ callback، واحتفظ بـ polling كمصدر الحقيقة في حال فوات callback أو وجود آلية تسليم خاصة بالمزوّد.Documentation Index
Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt
Use this file to discover all available pages before exploring further.
إنشاء مهمة فيديو
ينشئ الطلب التالي مهمة فيديو بسيطة ويخزّن المعرّف المُعاد. أضف حقول المدة أو الدقة أو callback فقط عندما توثّق صفحة model المحدد هذه الحقول.الاستعلام عن الحالة
يفحص الطلب التالي حالة مهمة الفيديو:video_url عندما يوفّر model adapter عنوان URL للنتيجة؛ وإلا فاستخدم حقول النتيجة الخاصة بـ model أو مسار المحتوى /v1/videos/{id}/content عندما يدعم ذلك model التنزيلات الممرّرة عبر الوكيل.
استلام webhook
لا يعرّف CometAPI حمولة callback موحّدة واحدة لكل model فيديو. تعامل مع callbacks على أنها أحداث تمرير مباشر خاصة بالمزوّد، وخزّن النص الخام للطلب، وطابق الحالة النهائية باستخدام polling. يعالج معالج Express التالي callback للفيديو ويخزّن الحدث:الأخطاء الشائعة
| الخطأ | الإصلاح |
|---|---|
| فقدان callback | استخدم polling عبر معرّف المهمة حتى يخزّن تطبيقك حالة نهائية. |
| callback مكرر | اجعل معالجة callback idempotent باستخدام معرّف المهمة. |
| رفض callback | أرجع استجابة 2xx بسرعة، ثم عالج المهمة في الخلفية. |
| عدم تطابق حمولة خاصة بالمزوّد | خزّن حمولة callback الخام وقم بتوحيدها داخل تطبيقك. |
عدم وجود video_url | تعامل مع video_url على أنه اختياري واستخدم polling بالإضافة إلى حقول النتيجة الخاصة بـ model أو /v1/videos/{id}/content عند توفره. |