استرجاع الفيديو

استخدم CometAPI GET /v1/videos/ لاسترجاع حالة فيديو Sora 2، والتقدم، والبيانات الوصفية مثل المدة والأبعاد والطوابع الزمنية ووقت الانتهاء.

GET /v1/videos/{video_id}

Retrieve a Sora video job

cURL

curl --request GET \
  --url https://api.cometapi.com/v1/videos/{video_id} \
  --header 'Authorization: Bearer <token>'

200

{
  "id": "video_69b25d5f467c81908733a56bc236b4df",
  "size": "1280x720",
  "error": null,
  "model": "sora-2",
  "object": "video",
  "prompt": "A paper airplane glides across a desk.",
  "status": "in_progress",
  "seconds": "4",
  "progress": 0,
  "created_at": 1773296991,
  "expires_at": null,
  "completed_at": null,
  "remixed_from_video_id": null
}

استخدم نقطة النهاية هذه بعد بدء مهمة Sora. فهي تعرض الحالة الحالية للمهمة، والحجم والمدة المكوّنين، وأي خطأ يعيده المزوّد.

​

راقب هذه الحقول

• status لمعرفة حالة دورة الحياة
• progress للحصول على إشارة تقريبية عن التقدم
• error عندما يرفض المزوّد المهمة أو تفشل
• expires_at بعد الاكتمال إذا كنت بحاجة إلى معرفة وقت انتهاء صلاحية الأصول المؤقتة

​

نفّذ Poll حتى الاكتمال

1. أنشئ الفيديو أو أعد مزجه أولاً

   ابدأ باستخدام Create Video أو Remix Video.

2. نفّذ Poll باستخدام المعرّف

   مرّر id المُعاد هنا واستمر في التحقق حتى تصل المهمة إلى completed أو failed.

3. نزّل الملف

   عندما تصبح المهمة completed، انتقل إلى Retrieve Video Content.

​

شكل الاستجابة في CometAPI

تتطابق هذه الخطوة بشكل وثيق مع سير عمل Polling في Sora. يحتفظ CometAPI بشكل الكائن بأسلوب OpenAI حتى تتمكن من ربط فحوصات الحالة بأقل قدر من التعديل.

التفويضات

Authorization · string · header · مطلوب

Bearer token authentication. Use your CometAPI key.

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

video_id · string · مطلوب

Video id returned by the create or remix endpoint.

الاستجابة

200 - application/json

Current job state.

id · string · مطلوب

size · string · مطلوب

model · string · مطلوب

object · string · مطلوب

status · string · مطلوب

seconds · string · مطلوب

progress · integer · مطلوب

created_at · integer · مطلوب

error · object

prompt · string

expires_at · integer | null

completed_at · integer | null

remixed_from_video_id · string | null