تسليم غير متزامن

مهام فيديو موثوقة بالحالة وwebhooks

استخدم الاستعلام للعملاء البسطاء أو webhooks للتسليم التلقائي ضمن دورة واحدة.

إنشاء مهمة مع webhook
curl -X POST https://sora2-api.com/api/v1/video/sora-video \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "sora-2",
    "prompt": "A tracking shot through a quiet night market",
    "aspectRatio": "16:9",
    "webHook": "https://api.example.com/webhooks/video",
    "isPublic": false
  }'

# Your webhook receives a terminal payload:
{
  "id": "task_123",
  "status": "succeeded",
  "progress": 100,
  "results": [{ "url": "https://storage.example/video.mp4" }]
}

دورة حياة واحدة وطريقتا تسليم

احفظ كل معرف واعتبر succeeded وfailed الحالتين النهائيتين فقط.

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

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

20 طلبًا متزامنًا

معالجة ما يصل إلى 20 مهمة إنشاء فيديو في وقت واحد. اتصل بنا للحصول على حدود أعلى.

فواتير شفافة

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

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

قواعد تسليم webhook

أعد 2xx بسرعة وعالج الأحداث بصورة متكررة آمنة واحتفظ بالاستعلام للاسترداد.

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

أرسل طلب 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 في حمولة نتيجة التحقق لمسارات التدقيق.

أطلق إنشاءً غير متزامن موثوقاً

ابدأ بالاستعلام ثم أضف webhooks دون تغيير عقد الإنشاء.