دليل الانتقال

خطط لما بعد Sora 2

حافظ على استقرار المنتج بعقد محايد وتخزين خاص ونماذج بديلة مختبرة.

طلب محايد تجاه المزود
type VideoGenerationRequest = {
  prompt: string;
  imageUrl?: string;
  aspectRatio: "16:9" | "9:16";
  durationSeconds: number;
  quality: "standard" | "high";
  callbackUrl?: string;
};

type VideoGenerationResult = {
  id: string;
  status: "queued" | "running" | "succeeded" | "failed";
  progress: number;
  outputUrl?: string;
  errorCode?: string;
};

interface VideoProvider {
  create(input: VideoGenerationRequest): Promise<{ id: string }>;
  retrieve(id: string): Promise<VideoGenerationResult>;
}

افصل منتجك عن النموذج

وحّد المدخلات والحالات والأخطاء والروابط قبل رمز المزود.

سورا 2 + مستقر + برو

اختر سلسلة النموذج التي تتوافق مع احتياجات الجودة والتكلفة الخاصة بك: sora-2، أو sora-2-stable، أو sora-2-pro.

فواتير شفافة

تبلغ تكلفة كل مكالمة 100 نقطة مقابل 10 ثوانٍ من sora-2/sora-2-stable، أو 150 نقطة مقابل 15 ثانية من sora-2/sora-2-stable، أو 150 نقطة مقابل sora-2-pro، مع استرداد الأموال تلقائيًا عند فشل الجيل.

الاقتراع المتوقع

أنشئ مهمة، ثم قم باستقصاء نقطة نهاية نتيجة التحقق للحفاظ على مزامنة الحالة والتقدم بدون SSE.

تدفق التكامل الموصى به

موعد الانتقال

تخطط OpenAI لإيقاف Sora 2 وVideos API في 24 سبتمبر 2026. اختبر بديلاً قبل الإطلاق.

قم بإنشاء المهمة

أرسل طلب Tikdek مع الموجه الخاص بك، ثم قم بتخزين معرف المهمة الذي تم إرجاعه.

تتبع التقدم

اتصل بنقطة نهاية نتيجة التحقق حتى تصبح الحالة ناجحة أو فاشلة.

تسليم الفيديو

استخدم عناوين URL المدعومة بالتخزين في result_url/result_urls لعرض الفيديو الذي تم إنشاؤه أو تنزيله.

الأسئلة المتداولة

كيف يمكنني التحقق من طلباتي؟

قم بإنشاء مفتاح API في وحدة التحكم، ثم قم بتضمينه كتفويض: Bearer YOUR_API_KEY. يمكن تدوير المفاتيح في أي وقت.

كيف يجب أن أقوم باستطلاع النتائج؟

بعد استدعاء إنشاء، قم بتخزين معرف المهمة. اتصل بـ /api/video- Generations/check-result كل 3 إلى 5 ثوانٍ حتى تنجح الحالة أو تفشل، ثم استخدم result_url/result_urls.

كيف يتم التعامل مع الاعتمادات للفشل؟

نقوم تلقائيًا برد الأرصدة عند فشل المهمة ونعيد Refund_trans_no plus Credits_refunded=true في حمولة نتيجة التحقق لمسارات التدقيق.

اجعل تغيير النموذج القادم إجراءً عادياً

ثبّت نقاط التطبيق وضع اختيار المزود في محول قابل للاستبدال.