الاقتراع المتوقع
أنشئ مهمة، ثم قم باستقصاء نقطة نهاية نتيجة التحقق للحفاظ على مزامنة الحالة والتقدم بدون SSE.
استخدم الاستعلام للعملاء البسطاء أو webhooks للتسليم التلقائي ضمن دورة واحدة.
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 مهمة إنشاء فيديو في وقت واحد. اتصل بنا للحصول على حدود أعلى.
تبلغ تكلفة كل مكالمة 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 دون تغيير عقد الإنشاء.