الانتقال إلى المحتوى الرئيسي
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 من صفحة النماذج عند تعيين model.

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

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

تدفق المهمة

1

إرسال مهمة Veo

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

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

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

احفظ النتيجة

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

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

توثّق Google خدمة Veo من خلال عمليات الفيديو طويلة التشغيل الخاصة بـ Gemini وتستخدم أسماء نماذج مثل veo-3.1-generate-preview. يحتفظ CometAPI بمسار /v1/videos المشترك ويحلّل اسم Veo المستعار الحالي من صفحة النماذج وقت الطلب. أثناء التحقق المباشر بتاريخ 2026-03-12، تم قبول طلب باستخدام veo3-fast وأعاد معرّف مهمة غير متزامنة، كما أن model في الاستجابة تم تحليله إلى معرّف نموذج خاص بالمزوّد بدلًا من إعادة الاسم المستعار المُرسل.

التفويضات

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
مطلوب