أدلة التكامل
الأخطاء
الأسعار والفوترة
واجهة API الرسمية
إنشاء فيديو
استخدم POST /v1/videos لإنشاء مهام توليد فيديو Sora 2 من Prompts نصية أو صور مرجعية، ثم استعلم عن الحالة باستخدام معرف المهمة للحصول على النتائج.
POST
/
v1
/
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ما لم تكن تحتاج تحديدًا إلى إخراج عمودي - ارفع صورة مرجعية واحدة كحد أقصى
التدفق الكامل من البداية إلى النهاية
الاستعلام حتى تنتهي المهمة
استدعِ Retrieve Video إلى أن تصبح الحالة
completed أو failed.تنزيل النتيجة أو إنشاء Remix لها
عند اكتمال الـ render، اجلب الملف باستخدام Retrieve Video Content. وإذا كنت تريد تنويعًا موجّهًا، فاستخدم Remix Video على النتيجة المكتملة.
سلوك Sora الذي لا يزال ساريًا
توثّق OpenAI نفس تدفق الإنشاء -> الاسترجاع -> التنزيل في Videos API. في CometAPI، تحافظ على بنية طلب Sora نفسها، لكنك تستخدم عنوان URL الأساسي ومفتاح CometAPI. روابط التنزيل النهائية مؤقتة، لذا انسخ الأصول المكتملة إلى مساحة التخزين الخاصة بك إذا كنت بحاجة إلى الاحتفاظ بها لفترة طويلة.التفويضات
Bearer token authentication. Use your CometAPI key.
الجسم
multipart/form-data
Text prompt that describes the video you want to create.
مثال:
"A paper airplane glides across a desk."
Sora model ID. Choose a current model from the Models page.
مثال:
"sora-2"
Clip duration in seconds.
الخيارات المتاحة:
4, 8, 12 مثال:
"4"
Output resolution formatted as width x height.
الخيارات المتاحة:
720x1280, 1280x720, 1024x1792, 1792x1024 مثال:
"1280x720"
Optional reference image uploaded as a file. The image should match the target size you request.
⌘I
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"
}