ما الذي ستقوم ببنائه
سترسل مهمة فيديو Sora 2، وتخزّن معرّف الفيديو المُعاد، وتستطلع حتى تكتمل المهمة، ثم تنزّل محتوى الفيديو النهائي.المتطلبات المسبقة
- مفتاح CometAPI API مخزّن في
COMETAPI_KEY - Python 3.10+ مع
requests، أو Node.js 18+ - عامل من جهة الخادم أو قائمة انتظار مهام للاستطلاع
مفتاح API، وعنوان URL الأساسي، والمصادقة
أنشئ مهام Sora باستخدام:أمثلة على الشيفرة
استخدم علامات التبويب أدناه للحصول على أمثلة قابلة للنسخ في cURL وPython وNode.js.شرح التدفق
يكون إنشاء Sora غير متزامنًا. تعيد نقطة نهاية الإنشاء معرّف فيديو وحالة أولية. قم باستطلاعGET /v1/videos/<video_id> إلى أن تصبح status هي completed أو failed. عند اكتمال المهمة، نزّل الملف باستخدام GET /v1/videos/<video_id>/content.
استخدم مقاسات WxH الدقيقة. يوضح مرجع Sora API المقاسات القياسية الأفقية والعمودية، مع مقاسات Pro أكبر لسير عمل نماذج Pro.
المعلمات الشائعة
استكشاف الأخطاء وإصلاحها / الأسئلة الشائعة
يفشل طلب الإنشاء
يفشل طلب الإنشاء
استخدم بيانات نموذج multipart. تستخدم طلبات إنشاء Sora في المرجع حقول النموذج، وليس body بصيغة JSON.
يفشل تنزيل المحتوى
يفشل تنزيل المحتوى
نزّل المحتوى فقط بعد أن تُبلغ نقطة نهاية الحالة عن
completed. خزّن الملف المكتمل في وحدة التخزين الخاصة بك.حجم Pro لا يعمل
حجم Pro لا يعمل
استخدم أحجام Pro الأكبر فقط مع سير عمل model من Pro. ابدأ بـ
1280x720 لأول طلب.الخطوات التالية
- اقرأ المرجع الخاص بواجهة Create a Sora 2 video.
- استخدم polling عبر Retrieve a Sora 2 video.
- نزّل عبر Retrieve Sora 2 video content.
- اعثر على نماذج الفيديو المتاحة في Models.
- راجع استخدام polling وwebhooks لتوليد الفيديو.
- قدّر تكلفة المهمة عبر تقدير تكلفة الطلب قبل استدعاء model.