إنشاء فيديو - CometAPI Documentation

POST

videos

Create a Sora 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 airplane glides across a desk.' \
  --form input_reference='@example-file'

{
  "created_at": 1773296991,
  "id": "video_69b25d5f467c81908733a56bc236b4df",
  "model": "sora-2",
  "object": "video",
  "progress": 0,
  "seconds": "4",
  "size": "1280x720",
  "status": "queued"
}

استخدم نقطة النهاية هذه لبدء مهمة render جديدة في Sora انطلاقًا من النص، أو من النص مع صورة مرجعية واحدة. يعيد الـ API معرف الفيديو فورًا ولا ينتظر حتى يكتمل الـ render.

ابدأ بأصغر مهمة مفيدة

استخدم sora-2 للحصول على تكرارات أسرع أو sora-2-pro عندما تكون جودة المخرجات أهم من السرعة
اجعل seconds مساويًا لـ 4 في طلبك الأول
ابدأ بـ size: 1280x720 ما لم تكن تحتاج تحديدًا إلى إخراج عمودي
ارفع صورة مرجعية واحدة كحد أقصى

التدفق الكامل من البداية إلى النهاية

إنشاء مهمة render

أرسل model وprompt وseconds وsize، ثم احفظ قيمة id المُعادة.

الاستعلام حتى تنتهي المهمة

استدعِ Retrieve Video إلى أن تصبح الحالة completed أو failed.

تنزيل النتيجة أو إنشاء Remix لها

عند اكتمال الـ render، اجلب الملف باستخدام Retrieve Video Content. وإذا كنت تريد تنويعًا موجّهًا، فاستخدم Remix Video على النتيجة المكتملة.

سلوك Sora الذي لا يزال ساريًا

توثّق OpenAI نفس تدفق الإنشاء -> الاسترجاع -> التنزيل في Videos API. في CometAPI، تحافظ على بنية طلب Sora نفسها، لكنك تستخدم عنوان URL الأساسي ومفتاح CometAPI. روابط التنزيل النهائية مؤقتة، لذا انسخ الأصول المكتملة إلى مساحة التخزين الخاصة بك إذا كنت بحاجة إلى الاحتفاظ بها لفترة طويلة.

التفويضات

Authorization

string

header

مطلوب

Bearer token authentication. Use your CometAPI key.

الجسم

multipart/form-data

prompt

string

مطلوب

Text prompt that describes the video you want to create.

مثال:

"A paper airplane glides across a desk."

model

string

افتراضي:sora-2

Sora model ID. Choose a current model from the Models page.

مثال:

"sora-2"

seconds

enum<string>

افتراضي:4

Clip duration in seconds.

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

4,

8,

12

مثال:

"4"

size

enum<string>

افتراضي:1280x720

Output resolution formatted as width x height.

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

720x1280,

1280x720,

1024x1792,

1792x1024

مثال:

"1280x720"

input_reference

file

Optional reference image uploaded as a file. The image should match the target size you request.

الاستجابة

200 - application/json

Video job accepted.

created_at

integer

مطلوب

string

مطلوب

model

string

مطلوب

object

string

مطلوب

progress

integer

مطلوب

seconds

string

مطلوب

size

string

مطلوب

status

string

مطلوب

ما نماذج الفيديو التي يمكنني استخدامها مع CometAPI؟

إعادة مزج الفيديو

Create a Sora 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 airplane glides across a desk.' \
  --form input_reference='@example-file'

{
  "created_at": 1773296991,
  "id": "video_69b25d5f467c81908733a56bc236b4df",
  "model": "sora-2",
  "object": "video",
  "progress": 0,
  "seconds": "4",
  "size": "1280x720",
  "status": "queued"
}

Documentation Index

​ابدأ بأصغر مهمة مفيدة

​التدفق الكامل من البداية إلى النهاية

​سلوك Sora الذي لا يزال ساريًا

التفويضات

الجسم

الاستجابة

ابدأ بأصغر مهمة مفيدة

التدفق الكامل من البداية إلى النهاية

سلوك Sora الذي لا يزال ساريًا