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

استخدم واجهة CometAPI Veo3 Retrieve API ‏(GET /v1/videos/) لجلب الحالة، والاستعلام عن البيانات الوصفية، أو تنزيل نتائج إنشاء فيديو Veo3 باستخدام video_id.

GET /v1/videos/{video_id}

Retrieve a Veo video job

cURL

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

200

{
  "id": "task_pa9CKKtYlTdxO7IIHOKKhXfjxEu4EQoR",
  "size": "16x9",
  "model": "veo_3_1-4K",
  "object": "video",
  "status": "queued",
  "task_id": "task_pa9CKKtYlTdxO7IIHOKKhXfjxEu4EQoR",
  "progress": 0,
  "created_at": 1773297229
}

استخدم نقطة النهاية هذه لاستطلاع مهمة Veo. فهي تُرجع حالة المهمة الحالية ومعلومات نموذج backend التي تم تحديدها.

​

حلقة الاستطلاع

1. أنشئ المهمة أولاً

   ابدأ بـ Veo3 Async Generation واحفظ القيمة id المُعادة.

2. استطلع حتى تصبح المهمة في حالة نهائية

   استمر في استدعاء نقطة النهاية هذه حتى تغادر المهمة الحالة queued أو in_progress وتصل إلى حالة مكتملة.

3. خزّن النتيجة

   بمجرد أن يصبح الإخراج جاهزًا، انقله إلى وحدة التخزين الخاصة بك إذا كان تطبيقك يحتاج إلى نسخة دائمة.

​

لماذا قد يتغير model ID

قد تُظهر الاستجابة model id الخاص بـ backend الذي تم تحديده بدلًا من alias الذي أرسلته. وهذا سلوك متوقع.

التفويضات

Authorization · string · header · مطلوب

Bearer token authentication. Use your CometAPI key.

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

video_id · string · مطلوب

Task id returned by the create endpoint.

الاستجابة

200 - application/json

Current job state.

id · string · مطلوب

size · string · مطلوب

model · string · مطلوب

object · string · مطلوب

status · string · مطلوب

progress · integer · مطلوب

created_at · integer · مطلوب

task_id · string