توليد الفيديو غير المتزامن

POST

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 مرتّبين

تدفق المهمة

إرسال مهمة Veo

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

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

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

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

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

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

قد يعرض الحقل 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. 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

مطلوب

string

مطلوب

model

string

مطلوب

Provider model identifier resolved by CometAPI for this task.

object

string

مطلوب

progress

integer

مطلوب

seconds

string

مطلوب

size

string

مطلوب

status

string

مطلوب

استرجاع محتوى الفيديو

استرجاع الفيديو

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"
}

Documentation Index

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

​تدفق المهمة

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

التفويضات

الجسم

الاستجابة

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

تدفق المهمة

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