الانتقال إلى المحتوى الرئيسي
GET
/
v1
/
videos
/
{video_id}
Retrieve a Veo video job
curl --request GET \
  --url https://api.cometapi.com/v1/videos/{video_id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "task_pa9CKKtYlTdxO7IIHOKKhXfjxEu4EQoR",
  "size": "16x9",
  "model": "veo_3_1-4K",
  "object": "video",
  "status": "queued",
  "task_id": "task_pa9CKKtYlTdxO7IIHOKKhXfjxEu4EQoR",
  "progress": 0,
  "created_at": 1773297229
}
استخدم نقطة النهاية هذه لاستقصاء مهمة Veo تم إنشاؤها عبر مُغلّف CometAPI /v1/videos. وهي تعيد حالة المهمة الحالية ومعلومات نموذج backend الفعلية التي يستخدمها CometAPI لهذه المهمة.

حلقة الاستقصاء

1

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

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

استقصِ حتى تصل المهمة إلى حالة نهائية

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

احفظ النتيجة

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

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

لا تزال آلية Veo الرسمية من Google تعتمد على حلقة استقصاء غير متزامنة. يحافظ CometAPI على هذا النمط، لكن تتم تسوية الاستجابة داخل مُغلّف /v1/videos وقد تُظهر معرّف نموذج backend الفعلي بدلًا من الاسم المستعار الذي أرسلته.

التفويضات

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