حالة الفيديو الواحد

يقدم دليل واجهة برمجة التطبيقات هذا نظرة عامة حول كيفية تتبع حالة طلبات الفيديو الفردية.

---

تتيح هذه الواجهة للمستخدمين التحقق من حالة طلب الفيديو من خلال تقديم "معرّف الفيديو". تتضمن الاستجابة ما يلي:

• الحالة: تشير إلى الحالة الحالية لطلب الفيديو (معلق، مكتمل، أو فاشل). إذا كانت الحالة "معلق"، فلا يزال الفيديو قيد التوليد وسيكون جاهزًا قريبًا. إذا كانت الحالة "مكتمل"، فقد تم توليد الفيديو بنجاح. إذا كانت الحالة "فشل"، فقد فشل توليد الفيديو.
• عنوان URL للفيديو: إذا كانت الحالة "مكتمل"، فإنه يحتوي على رابط الوصول إلى الفيديو. إذا كانت الحالة "معلق"، فإنه يشير إلى أن الفيديو قيد التقدم. إذا كانت الحالة "فشل"، فإنه يشير إلى أن توليد الفيديو لم ينجح.

طلبالاستجابة (معلقة)الاستجابة (مكتملة)الاستجابة (فشلت)

curl --request GET \
     --url 'https://api.immersive-fox.com/v1/video_requests/status/<video_id>' \
     --header 'X-Api-Key: <your-api-key>' \
     --header 'Content-Type: application/json' \

{
    "status": "Pending",
    "video_url": "Video generation in progress, will be ready soon!"
}

{
    "status": "Completed",
    "video_url": "https://api.immersive-fox.com/v/<video_hash>"
}

{
    "status": "Failed",
    "video_url": "Video generation failed, no video url is available!"
}