TikdekTikdek
سورا 2 برو API

دمج Sora 2 Pro عبر API

أنشئ مهام فيديو نصية أو صورة أو لوحة عمل باستخدام /api/v1/video/sora-pro، ثم قم باستقصاء الحالة وتقديم النتائج مع نتيجة التحقق.

إنشاء مفتاح APIعرض التسعير

كل ما تحتاجه لتسليم Sora 2 Pro

تغطي واجهة برمجة التطبيقات One سير عمل Sora 2 وSora 2 Pro والقصة المصورة مع فواتير واضحة واستطلاعات يمكن التنبؤ بها.

سبعة نماذج معتمدة

اختر من بين نص/صورة Sora 2، ونص/صورة Sora 2 Stable، ومتغيرات النص/الصورة/لوحة العمل لـ Sora 2 Pro.

الاعتمادات المتدرجة

مقياس الاعتمادات مع المدة والجودة، بما في ذلك المستوى القياسي/العالي لـ Sora 2 Pro.

التسليم على أساس المهام

أنشئ مهمة واستقصي نتيجة التحقق وأرسل النتيجة النهائية لـ result_url.

المصادقة وعنوان URL الأساسي

يتم تقديم كافة نقاط النهاية من https://sora2-api.com. أرسل مفتاح API من وحدة التحكم في رأس التفويض.

  • قم بتضمين التفويض: الحامل YOUR_API_KEY في كل طلب.
  • استخدم نوع المحتوى: application/json لحمولات JSON.
  • تتضمن الردود الرمز/الرسالة/البيانات؛ يمكن أن ترجع نتيجة التحقق 4xx/5xx لذا قم بالتحقق من صحة حالة HTTP أيضًا.

الاعتمادات والفواتير

تختلف الفواتير حسب الطراز والمدة ومستوى الجودة.

  • سورا 2 نص/صورة: 10 ث = 100 نقطة، 15 ث = 150 نقطة.
  • سورا 2 نص/صورة ثابتة: 10 ث = 100 نقطة، 15 ث = 150 نقطة.
  • نص/صورة Sora 2 Pro: 10ث = 375، 15ث = 675.
  • لوحة القصة المصورة Sora 2 Pro: 10ث = 375، 15ث = 675، 25ث = 875.
  • الأسعار المذكورة أعلاه نهائية. يتم تقريب الرسوم.

نقاط النهاية الأساسية

ابدأ بإنشاء مهمة إنشاء، ثم قم باستقصاء رصيدك الائتماني أو التحقق منه.

قم بإنشاء فيديو Sora 2 Pro

أرسل وظائف نصية أو صورية أو لوحة عمل، وقم بخصم الاعتمادات على الفور، واحصل على معرف المهمة.

الطريقة: POSTالمسار: /api/v1/video/sora-pro

معلمات الحمولة

  • النموذج: مطلوب. استخدم إحدى سلاسل النماذج المدعومة أعلاه.
  • موجه: مطلوب باستثناء القصة المصورة. قم بوصف المشهد الذي تريد إنشاءه.
  • بيانات الصورة: مطلوبة لتحويل الصورة إلى فيديو. عنوان URL لبيانات Base64 مع البادئة "data:image/*;base64,".
  • عنوان الصورة: اختياري. عنوان URL للصورة العامة إذا كنت تفضل عدم إرسال base64.
  • نسبة العرض إلى الارتفاع: اختيارية. "منظر طبيعي" أو "صورة" (المناظر الطبيعية الافتراضية).
  • nFrames: اختياري. "10"/"15"/"25" (25 هي القصة المصورة فقط).
  • الحجم: اختياري (نص/صورة احترافية). "قياسي" أو "عالي".
  • إزالة العلامة المائية: اختياري (نص/صورة). إزالة علامة العلامة المائية، الافتراضي صحيح.
  • لقطات: مطلوبة للقصة المصورة. مجموعة من اللقطات مع المشهد والمدة.
  • isPublic: اختياري. سواء كانت النتيجة عامة، فالافتراضي صحيح.

ملاحظات

  • النماذج المدعومة: sora-2-text-to-video، sora-2-image-to-video، sora-2-text-to-video-stable، sora-2-image-to-video-stable، sora-2-pro-text-to-video، sora-2-pro-image-to-video، sora-2-pro-storyboard.
  • يتم خصم الاعتمادات عند الإرسال؛ يتم استرداد المهام الفاشلة تلقائيًا.
  • يتطلب وضع القصة المصورة مجموعة اللقطات.

هيكل اللقطات

مطلوب لطلبات القصة المصورة. يحدد كل عنصر مشهدًا ومدته.

[
  { "scene": "مقهى مريح عند شروق الشمس، ضوء دافئ.", "duration": 7.5 }
]
  • المشهد: وصف اللقطة.
  • المدة: ثانية (يدعم الكسور العشرية مثل 7.5).

طلب عينة

curl -X POST https://sora2-api.com/api/v1/video/sora-pro \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sora-2-pro-text-to-video",
    "prompt": "تعقب سينمائي تم تصويره عبر سوق شارع مضاء بالنيون عند الغسق.",
    "aspectRatio": "landscape",
    "nFrames": "10",
    "size": "high",
    "removeWatermark": true,
    "isPublic": true
  }'

استجابة العينة

{
  "code": 0,
  "message": "ok",
  "data": {
    "id": "task_1234567890",
    "taskId": "task_1234567890"
  }
}

التحقق من نتيجة التوليد

حالة مهمة الاستطلاع ومزامنة النتائج.

الطريقة: POSTالمسار: /api/video-generations/check-result

معلمات الحمولة

  • معرف المهمة: مطلوب. تم إرجاع المعرف عندما قمت بإنشاء مهمة الإنشاء.

ملاحظات

  • يُرجع الحالة والتقدم وresult_url عندما يكون ذلك متاحًا.
  • قد يُرجع 4xx/5xx للتحقق من الصحة أو الإذن أو الحالات التي لم يتم العثور عليها.

طلب عينة

curl -X POST https://sora2-api.com/api/video-generations/check-result \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "taskId": "task_1234567890"
  }'

استجابة العينة

{
  "code": 0,
  "message": "Success",
  "data": {
    "task_id": "task_1234567890",
    "status": "running",
    "progress": 0,
    "result_url": ""
  }
}

الحصول على اعتمادات المستخدم

جلب الاعتمادات المتبقية وحالة VIP.

الطريقة: POSTالمسار: /api/get-user-credits

ملاحظات

  • يتطلب مفتاح API أو جلسة صالحة.
  • إرجاع الحقول left_credits وis_vip.

طلب عينة

curl -X POST https://sora2-api.com/api/get-user-credits \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

استجابة العينة

{
  "code": 0,
  "message": "ok",
  "data": {
    "left_credits": 120,
    "is_vip": true
  }
}

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

أرسل /api/v1/video/sora-pro مع الحمولة الخاصة بك، ثم قم بتخزين معرف المهمة.

2. تتبع التقدم

استطلاع /api/video- Generations/check-result حتى تنجح الحالة أو تفشل.

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

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

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

ما هي النماذج المدعومة؟

استخدم sora-2-text-to-video أو sora-2-image-to-video؛ يضيف Sora 2 Pro متغيرات النص والصورة والقصة المصورة.

ما هي القيم التي يدعمها nFrames؟

استخدم "10" أو "15" لجميع الأوضاع؛ "25" مخصص للوحة القصة فقط. يدعم النص/الصورة الاحترافية الحجم القياسي أو العالي.

لماذا يمكن أن ترجع نتيجة التحقق 4xx/5xx؟

تتحقق نقطة النهاية من الملكية والإدخال، لذلك يمكن للمهام غير الصالحة أو غير المصرح بها إرجاع 4xx/5xx إلى جانب الرمز/الرسالة.

موارد مفيدة

وحدة تحكم مفاتيح API

قم بإنشاء وتدوير وإلغاء مفاتيح واجهة برمجة التطبيقات (API) لعمليات التكامل الخاصة بك.

التسعير

قم بمراجعة استهلاك الرصيد وخيارات التعبئة قبل الإطلاق.

اختبار واجهة برمجة التطبيقات عبر الإنترنت

جرب نقاط النهاية من خلال ملعب Apifox التفاعلي.

اتصل بالدعم

هل تحتاج إلى حد أعلى للسعر أو عقد مخصص؟ تواصل معنا عبر [email protected].

ابدأ باستخدام Tikdek Video API

قم بإنشاء مفتاح API الخاص بك وابدأ في إنشاء مقاطع فيديو Sora 2 Pro في دقائق.

انتقل إلى وحدة تحكم APIعرض التسعير