الانتقال إلى المحتوى الرئيسي
POST
/
v1
/
videos
Create a Veo video job
curl --request POST \
  --url https://api.cometapi.com/v1/videos \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form 'prompt=A paper kite floats above a field.' \
  --form input_reference='@example-file'
{
  "created_at": 1773297229,
  "id": "task_pa9CKKtYlTdxO7IIHOKKhXfjxEu4EQoR",
  "model": "veo_3_1-4K",
  "object": "video",
  "progress": 0,
  "seconds": "",
  "size": "16x9",
  "status": "queued"
}
استخدم هذه الصفحة لبدء مهمة Veo عبر المسار المشترك في CometAPI وهو /v1/videos. اختر اسمًا مستعارًا حاليًا لـ Veo من صفحة Models عند تعيين model.

اختر نمط الطلب

  • تحويل النص إلى فيديو: لا ترسل أي ملفات input_reference
  • تحويل الصورة إلى فيديو: أرسل ملف input_reference واحدًا
  • التوجيه باستخدام الإطار الأول والإطار الأخير: أرسل ملفّي input_reference مرتّبين

تدفق المهمة

1

إرسال مهمة Veo

أرسل اسمًا مستعارًا لـ Veo، وprompt، ومدخلات صور اختيارية، ثم احفظ id المُعاد.
2

الاستعلام عن نقطة نهاية الفيديو المشتركة

استخدم Veo3 Retrieve لمتابعة المهمة غير المتزامنة حتى تصل إلى حالة نهائية.
3

الاحتفاظ بالنتيجة

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

تحليل الاسم المستعار

قد يعرض الحقل model في الاستجابة معرّف نموذج الواجهة الخلفية الذي تم تحليله بدلًا من الاسم المستعار الذي أرسلته. استخدم صفحة Models للعثور على أسماء Veo المستعارة الحالية.

التفويضات

Authorization
string
header
مطلوب

Bearer token authentication. Use your CometAPI key.

الجسم

multipart/form-data
prompt
string
مطلوب

Text prompt for the video job.

مثال:

"A paper kite floats above a field."

model
string
افتراضي:veo3-fast

CometAPI Veo alias. Use a current Veo alias from the Models page. The response may resolve this alias to a provider model id.

مثال:

"veo3-fast"

size
string

Orientation hint used by the wrapper. Use a landscape-like value such as 16x9 or a portrait-like value such as 9x16.

مثال:

"16x9"

input_reference
file

Optional image input. Send one file for image-to-video or two ordered files for first-frame and last-frame guidance.

الاستجابة

200 - application/json

Task accepted.

created_at
integer
مطلوب
id
string
مطلوب
model
string
مطلوب

Provider model identifier resolved by CometAPI for this task.

object
string
مطلوب
progress
integer
مطلوب
seconds
string
مطلوب
size
string
مطلوب
status
string
مطلوب