إنشاء فيديو Veo 3
أنشئ فيديوهات Veo 3.1 بشكل غير متزامن عبر CometAPI باستخدام POST /v1/videos، ثم استعلم عن المهمة ونزّل ملف MP4 المكتمل.
id المُعادة واستعلم عن المهمة حتى تصل إلى حالة نهائية.
يستخدم POST /v1/videos نوع multipart/form-data؛ مرّر عناصر التحكم العددية أو النصية كحقول نموذج، ومدخلات الوسائط كحقول ملفات input_reference.
اختر نموذجًا
اختر وضع إدخال
حدّد المدة والحجم
بالنسبة للمسار المتوافق مع OpenAI، استخدمseconds للمدة وsize لحجم الإخراج. أرسل القيم كحقول نموذج.
size على إحدى قيم WxH أدناه.
تدفق المهمة
إنشاء المهمة
id المُعادة.الاستعلام عن المهمة
status هي completed أو failed أو error.تنزيل النتيجة
completed، نزّل ملف MP4 من استجابة المهمة المكتملة.التفويضات
Bearer authentication. Use your CometAPI API key.
الجسم
Veo 3.1 model ID. Use veo3.1-fast for the default route or veo3.1 when you specifically need the standard model.
veo3.1-fast, veo3.1 "veo3.1-fast"
Text prompt for the video job.
"A paper kite floats above a field."
Requested clip duration. Use 4, 6, or 8. Send the value as a form field string.
4, 6, 8 "4"
Supported WxH size values: 1280x720, 720x1280, 1920x1080, 3840x2160. Default is 1280x720.
"1280x720"
Optional first-frame image file for image-to-video.
الاستجابة
Task created. Store the returned id and poll GET /v1/videos/{task_id}.
Task ID. Use this value with retrieve and content endpoints.
"task_example"
Object type. Video tasks return video.
"video"
Model ID used for the task.
"veo3.1-fast"
Task lifecycle status. Poll until the value is completed, failed, or error.
queued, in_progress, completed, failed, error "queued"
Task progress as a coarse percentage.
0 <= x <= 1000
Task creation time as a Unix timestamp in seconds.
1779938152
Compatibility alias for id when present.
"task_example"
Task completion time as a Unix timestamp in seconds. This field appears on completed tasks.
1779938219
Temporary video delivery URL. This field appears on completed tasks.
"<temporary-video-url>"
Failure details. This field appears when the task fails.