إنشاء فيديو Sora 2

POST

videos

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F model=sora-2 \
  -F prompt="A paper boat drifts across a calm pond at sunrise" \
  -F seconds=4 \
  -F size=1280x720

{
  "id": "<video_id>",
  "task_id": "<video_id>",
  "object": "video",
  "model": "sora-2",
  "status": "queued",
  "progress": 0,
  "created_at": 1781079478,
  "seconds": "4",
  "size": "1280x720"
}

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

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

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

المدة والحجم

الإعداد	القيم المدعومة	نقطة البداية الافتراضية	سلوك الحدود
`seconds`	`4`, `8`, `12`, `16`, `20`	`4`	القيم الأخرى ليست جزءًا من بنية طلب فيديو Sora.
`size` لـ `sora-2`	`1280x720`, `720x1280`	`1280x720`	استخدم الاتجاه الأفقي أو العمودي.
`size` لـ `sora-2-pro`	`1792x1024`, `1024x1792`، بالإضافة إلى أحجام Sora القياسية	`1792x1024` لمخرجات Pro الأفقية	استخدم أحجام Pro الأكبر فقط مع نموذج Pro.

يتطلب Sora الحقل size بصيغة WxH الدقيقة. رموز الدقة مثل 720p وتسميات النسبة مثل 16:9 ليست قيم size صالحة لـ Sora في نقطة النهاية هذه.

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

إنشاء مهمة التصيير

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

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

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

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

عند اكتمال التصيير، اجلب الملف باستخدام Retrieve Video Content.

سلوك Sora الذي لا يزال مطبقًا

توثّق OpenAI نفس التدفق create -> retrieve -> download في 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 an available model from the Models page.

مثال:

"sora-2"

seconds

enum<string>

افتراضي:4

Clip duration in seconds. Use 4, 8, 12, 16, or 20.

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

4,

8,

12,

16,

20

مثال:

"4"

size

enum<string>

افتراضي:1280x720

Output resolution formatted as width x height. Use 1280x720 or 720x1280 for standard Sora output. Use 1792x1024 or 1024x1792 with a Pro model when you need larger Pro output.

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

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

مطلوب

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

استرجاع فيديو Sora 2

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F model=sora-2 \
  -F prompt="A paper boat drifts across a calm pond at sunrise" \
  -F seconds=4 \
  -F size=1280x720

{
  "id": "<video_id>",
  "task_id": "<video_id>",
  "object": "video",
  "model": "sora-2",
  "status": "queued",
  "progress": 0,
  "created_at": 1781079478,
  "seconds": "4",
  "size": "1280x720"
}

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

مفاتيح API

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

المدة والحجم

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

سلوك Sora الذي لا يزال مطبقًا

التفويضات

الجسم

الاستجابة

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

​المدة والحجم

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

​سلوك Sora الذي لا يزال مطبقًا

التفويضات

الجسم

الاستجابة

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

المدة والحجم

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

سلوك Sora الذي لا يزال مطبقًا