Skip to main content
POST
cURL
استخدم نقطة النهاية هذه لبدء مهمة فيديو Veo 3.1. تُرجع واجهة API معرّف مهمة فورًا، لذا خزّن قيمة id المُعادة واستعلم عن المهمة حتى تصل إلى حالة نهائية. يستخدم POST /v1/videos نوع multipart/form-data؛ مرّر عناصر التحكم العددية أو النصية كحقول نموذج، ومدخلات الوسائط كحقول ملفات input_reference.

اختر نموذجًا

اختر وضع إدخال

حدّد المدة والحجم

بالنسبة للمسار المتوافق مع OpenAI، استخدم seconds للمدة وsize لحجم الإخراج. أرسل القيم كحقول نموذج. اضبط size على إحدى قيم WxH أدناه.

تدفق المهمة

1

إنشاء المهمة

أرسل طلب النموذج متعدد الأجزاء وخزّن قيمة id المُعادة.
2

الاستعلام عن المهمة

استخدم Veo3 Retrieve حتى تصبح قيمة status هي completed أو failed أو error.
3

تنزيل النتيجة

عندما تكون المهمة completed، نزّل ملف MP4 من استجابة المهمة المكتملة.

التفويضات

Authorization
string
header
مطلوب

Bearer authentication. Use your CometAPI API key.

الجسم

multipart/form-data
model
enum<string>
مطلوب

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"

prompt
string
مطلوب

Text prompt for the video job.

مثال:

"A paper kite floats above a field."

seconds
enum<string>
افتراضي:4

Requested clip duration. Use 4, 6, or 8. Send the value as a form field string.

الخيارات المتاحة:
4,
6,
8
مثال:

"4"

size
string

Supported WxH size values: 1280x720, 720x1280, 1920x1080, 3840x2160. Default is 1280x720.

مثال:

"1280x720"

input_reference
file

Optional first-frame image file for image-to-video.

الاستجابة

Task created. Store the returned id and poll GET /v1/videos/{task_id}.

id
string
مطلوب

Task ID. Use this value with retrieve and content endpoints.

مثال:

"task_example"

object
string
مطلوب

Object type. Video tasks return video.

مثال:

"video"

model
string
مطلوب

Model ID used for the task.

مثال:

"veo3.1-fast"

status
enum<string>
مطلوب

Task lifecycle status. Poll until the value is completed, failed, or error.

الخيارات المتاحة:
queued,
in_progress,
completed,
failed,
error
مثال:

"queued"

progress
integer
مطلوب

Task progress as a coarse percentage.

النطاق المطلوب: 0 <= x <= 100
مثال:

0

created_at
integer
مطلوب

Task creation time as a Unix timestamp in seconds.

مثال:

1779938152

task_id
string

Compatibility alias for id when present.

مثال:

"task_example"

completed_at
integer

Task completion time as a Unix timestamp in seconds. This field appears on completed tasks.

مثال:

1779938219

video_url
string

Temporary video delivery URL. This field appears on completed tasks.

مثال:

"<temporary-video-url>"

error
object

Failure details. This field appears when the task fails.