إنشاء فيديو Omni

POST

videos

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F model=omni-fast \
  -F 'prompt=Ocean waves rolling onto a sandy beach at golden hour' \
  -F seconds=4 \
  -F aspect_ratio=16:9 \
  -F resolution=720p

{
  "id": "task_example",
  "task_id": "task_example",
  "object": "video",
  "model": "omni-fast",
  "status": "queued",
  "progress": 0,
  "created_at": 1779938152
}

استخدم نقطة نهاية بيتا هذه لإنشاء مهمة لتحويل النص إلى فيديو أو تحويل فيديو إلى فيديو. تُرجع API معرّف المهمة فورًا، لذا خزّن القيمة المُعادة id واستعلم عن المهمة دوريًا حتى تصل إلى حالة نهائية. اختر نوع محتوى الطلب الذي يطابق وضع الإدخال. أرسل عناصر التحكّم الخاصة بتحويل النص إلى فيديو كحقول multipart/form-data. أرسل تحرير فيديو مرجعي كنص طلب application/json.

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

الهدف	نوع المحتوى	الحقول المطلوبة	الحقول الاختيارية
تحويل النص إلى فيديو	`multipart/form-data`	`model`, `prompt`	`seconds`, `aspect_ratio`, `resolution`
تحويل فيديو إلى فيديو	`application/json`	`model`, `prompt`, `video`	`seconds`, `aspect_ratio`, `resolution`

تستخدم أمثلة تحويل النص إلى فيديو model=omni-fast. وتستخدم أمثلة تحويل فيديو إلى فيديو model=omni-fast-v2v. استخدم إدراج النماذج المتاحة للتأكد من أن معرّف نموذج ظاهر لمفتاح API الخاص بك.

حرّر فيديو مرجعيًا

لتحويل فيديو إلى فيديو، شفّر ملف MP4 محليًا باستخدام base64 وسبّق البايتات المشفّرة بـ data:video/mp4;base64,. أرسل عنوان URL الكامل للبيانات في الحقل video. صِف التغييرات المطلوبة في prompt. واذكر أيضًا الأشخاص أو العناصر أو التكوين أو الحركة التي ينبغي أن تحافظ عليها النتيجة. يتضمن محدد عيّنات التعليمات البرمجية أمثلة Shell وPython وJavaScript تقرأ reference.mp4 من دليل العمل. يغطي شكل الطلب هذا عنوان URL مضمنًا لبيانات MP4. ولا يعرّف إدخال URL أو تنسيقات حاويات فيديو أخرى أو حدود حجم الملفات.

عيّن المدة والنسبة والدقة

تم وضع علامة بيتا على Omni لأن استقرار التوليد قد يختلف حسب الإدخال والمسار المحدد. اجعل الطلب الأول صغيرًا، ثم افحص الفيديو المكتمل قبل الاعتماد على مدة عرض أو حجم إطار محدد.

الإعداد	القيم المدعومة	الافتراضي	سلوك الحدود
`seconds`	ابدأ بـ `4`	يعتمد على المسار	تعامل مع هذا كمدة مطلوبة وتحقق من ملف MP4 المكتمل لأن مدة الإخراج قد تختلف.
`aspect_ratio`	`16:9`, `9:16`, `1:1`	`16:9`	`9:16` يمكنه عرض مخرجات عمودية. يمكن قبول `1:1` أثناء العرض الأفقي.
`resolution`	ابدأ بـ `720p`؛ يمكن قبول `1080p`	`720p`	قد تُوحِّد مخرجات الإنتاج الحالية القيمة إلى `720p` حتى عند طلب `1080p`.

الطلب	الإطار المكتمل المرصود
`resolution=720p`, `aspect_ratio=16:9`	`1280x720`
`resolution=720p`, `aspect_ratio=9:16`	`720x1280`
`resolution=720p`, `aspect_ratio=1:1`	`1280x720`
`resolution=1080p`, `aspect_ratio=16:9`	`1280x720`

نظرًا لأن نقطة النهاية هذه بيتا، تعامل مع aspect_ratio وresolution كتفضيلات للتوليد وتحقق من ملف MP4 الذي تم تنزيله قبل الاعتماد على وحدات البكسل النهائية.

تدفق المهمة

إنشاء المهمة

أرسل الطلب بنوع المحتوى الخاص بوضع الإدخال المحدد وخزّن القيمة المُعادة id.

استعلم عن المهمة دوريًا

استدعِ استرداد فيديو Omni إلى أن تصبح قيمة status هي completed أو failed.

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

عندما تكون المهمة completed، استدعِ استرداد محتوى فيديو Omni لتنزيل ملف MP4.

التفويضات

Authorization

string

header

مطلوب

Bearer authentication. Use your CometAPI API key.

الجسم

model

string

مطلوب

Omni model ID for this endpoint. Use omni-fast for text-to-video.

مثال:

"omni-fast"

prompt

string

مطلوب

Text prompt that describes the video to generate.

مثال:

"Ocean waves rolling onto a sandy beach at golden hour"

seconds

string

Requested clip duration in seconds. The completed video can use a different duration.

مثال:

"4"

aspect_ratio

enum<string>

افتراضي:16:9

Output aspect ratio preference. 16:9 and 9:16 are the most predictable; 1:1 can be accepted but may render as landscape.

الخيارات المتاحة:

16:9,

9:16,

1:1

مثال:

"16:9"

resolution

string

Output resolution preference. Start with 720p. A request for 1080p can render at 720p.

مثال:

"720p"

الاستجابة

200 - application/json

Task accepted. Store the returned id and poll GET /v1/videos/{task_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.

مثال:

"omni-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.

Show child attributes

تنزيل محتوى فيديو Vidu

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

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F model=omni-fast \
  -F 'prompt=Ocean waves rolling onto a sandy beach at golden hour' \
  -F seconds=4 \
  -F aspect_ratio=16:9 \
  -F resolution=720p

{
  "id": "task_example",
  "task_id": "task_example",
  "object": "video",
  "model": "omni-fast",
  "status": "queued",
  "progress": 0,
  "created_at": 1779938152
}

الإشراف على المحتوى

مفاتيح API

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

حرّر فيديو مرجعيًا

عيّن المدة والنسبة والدقة

تدفق المهمة

التفويضات

الجسم

الاستجابة

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

​حرّر فيديو مرجعيًا

​عيّن المدة والنسبة والدقة

​تدفق المهمة

التفويضات

الجسم

الاستجابة

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

حرّر فيديو مرجعيًا

عيّن المدة والنسبة والدقة

تدفق المهمة