إنشاء مهمة
يتضمن طلب الفيديو عادةً prompt وmodel وخصائص الإطار مثل المدة أو نسبة الأبعاد أو الدقة أو المراجع فقط عندما يدعمها النموذج المختار.
احفظ معرّف المهمة فورًا. فهو مطلوب لإظهار التقدم ودعم الإلغاء في واجهتك والحصول على المحتوى النهائي.
مهمة إنشاء فيديو
bash
curl --request POST https://cicora.ai/api/v1/videos \
--header "Authorization: Bearer $CICORA_API_KEY" \
--header 'Content-Type: application/json' \
--data '{
"model": "google/veo-3.1",
"prompt": "Slow aerial movement above a river at sunrise",
"duration": 8,
"aspect_ratio": "16:9",
"resolution": "720p"
}'استطلاع الحالة
- اقرأ مهمة عبر GET /videos/{video_id}.
- اعتبر الحالة النهائية مصدر الحقيقة لاكتمال العملية.
- استخدم فاصل استطلاع متزايدًا وأوقفه عندما يغادر المستخدم.
التعامل مع النتيجة
بعد الاكتمال، استخدم عنوان URL أو المحتوى الذي تعيده المهمة وتحقق من جاهزية الملف قبل عرض مشغّل.
احتفظ بالمطالبة والنموذج والمعلمات ومعرّف المهمة للدعم، لكن لا تحتفظ بمراجع الإدخال مدة أطول مما يتطلبه منتجك.