طلب فيديو مجمع باستخدام قالب

يقدم دليل واجهة برمجة التطبيقات هذا نظرة عامة على إنشاء الطلبات المجمعة باستخدام القوالب.

---

تُبسط القوالب عملية إنشاء الطلبات المجمعة. لتقليل الحاجة إلى إدخال البيانات بشكل متكرر عند إنشاء مقاطع الفيديو، يمكنك إنشاء قالب باستخدام إنشاء قالب API. بمجرد إنشائه، يمكنك استخدام هذا القالب عدة مرات لإنشاء طلبات مجمعة بكفاءة. لمعرفة المزيد عن الطلب المجمع، اقرأ إنشاء طلب مجمع API مقدمة 🦊

بداية سريعة

لنبدأ في استكشاف كيفية إنشاء طلب مجمع باستخدام قالب مجمع.

إنشاء طلب مجمع من قالب يمكنك استخدام

'id' كـ 'template_id' الذي تم الحصول عليه إما من template listing API أو create template API. أدخل 'template_id' هذا مع "video_name" لإنشاء طلب مجمع. ستتلقى في الرد تفاصيل حول عدد مقاطع الفيديو الناجحة وأي مقاطع فيديو فشلت. استخدم المعرف 'id' من الرد للتحقق من حالة الطلب المجمع باستخدام bulk status API. الإعدادات اختيارية، فإذا أرسلت أي تكوين، فسيتم تحديثه في القالب وسيتم إنشاء الفيديوهات وفقًا للقالب الجديد. يُرجى ملاحظة أنه عند إدخال الإعدادات، يجب عليك أيضًا تحديد حقل "scene_number".

• 'id': مُعرّف الطلب المجمع.
• 'successful_requests_count': عدد الفيديوهات المُرسَلة بنجاح للمعالجة.
• 'failed_requests_count': عدد الفيديوهات التي لم تتم معالجتها.

Requestالرد

curl --request POST  \
     --url 'https://api.immersive-fox.com/v1/bulk_requests/generate_video_from_template/'  \
     --header 'X-Api-Key: <your-api-key>'  \
     --header 'Content-Type: application/json'  \
     --data { \
                "template_id": 45, \
                "csv_id": 123, \
                "configurations": [ \
                    { \
                        "scene_number": 1, \
                        "audio_text": "Hi, My name is {{First Name}}", \
                        "avatar": 102, \
                        "avatar_size": 76, \
                        "background_color": "#ffffff", \
                        "background_music_is_personalized": "system", \
                        "background_music_volume": 0.1, \
                        "frame_height": 1080, \
                        "frame_width": 1920, \
                        "is_personalized_audio": false, \
                        "scene_transition": "none", \
                        "audio_id": 2, \
                        "audio_service": "google_audio", \
                        "user_voice_speed": 1, \
                        "x_position": 0.604931, \
                        "y_position": 0.43101 \
                    } \
                ] \
            }

{
    "id": 108,
    "message": "Requests Created",
    "successful_requests_count": 3,
    "failed_requests_count": 0,
    "failed_requests": []
}