طلب فيديو مجمع

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

---

طلب فيديو

مجمع يسمح لك الطلب المجمع بإنشاء ملفات فيديو متعددة مخصصة دفعة واحدة باستخدام ملف CSV يحتوي على بيانات خاصة بالمستخدم. بدلاً من إنشاء كل ملف صوتي على حدة، يمكنك إدخال حقول مختلفة، مثل الأسماء وتفاصيل الشركة، في ملف CSV، وسيقوم النظام تلقائيًا بإنشاء ملفات صوتية مخصصة لكل إدخال. 🦊

لنفترض أنك تريد إنشاء ملفات صوتية مخصصة لمستخدمين متعددين. يحتوي ملف CSV الخاص بك على البيانات التالية:

الاسم الأول	اسم الشركة
جون	شركة Acme Corp
جين	شركة Beta Ltd

الآن، في نص الصوت الخاص بك، يمكنك استخدام وحدات الماكرو المدعومة مثل هذا: "مرحبًا {{الاسم الأول}}، مرحبًا بك في {{اسم الشركة}}!" عند معالجة الطلب المجمع، سيتم استبدال وحدات الماكرو بالقيم من ملف CSV. ستكون الملفات الصوتية المُولّدة: ١. "مرحبًا جون سميث، مرحبًا بك في شركة Acme!" ٢. "مرحبًا جين دو، مرحبًا بك في شركة Beta Ltd!" يتيح لك هذا إنشاء ملفات صوتية مخصصة لكل مستخدم في ملف CSV الخاص بك، مما يجعل الطلبات المجمعة فعالة ومخصصة.

بدء سريع:

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

إنشاء طلب

مجمع لإنشاء طلب مجمع، استخدم طلب واجهة برمجة التطبيقات التالي. يتيح لك هذا تحديد إعدادات متنوعة، بما في ذلك النص الصوتي والصورة الرمزية والخلفية، لإنشاء طلب مجمع. خصص المعلمات لتناسب احتياجاتك. إذا كان لديك قالب مجمع، فاستخدم إنشاء قالب مجمع لإنشاء طلب مجمع. يمكنك الحصول على 'audio_id' و'audio_service' من واجهة برمجة تطبيقات قائمة الصوت و"csv_id" من واجهة برمجة تطبيقات قائمة csv. يمكنك استخدام وحدات الماكرو بتنسيق '{{}}' ضمن 'audio_text'، والتي سيتم استبدالها ديناميكيًا بقيم من ملف CSV الذي قدمته. على سبيل المثال، إذا أضفت '{{First Name}}' في نصك، فسيتم استبداله بأسماء مثل "John" و"Smith" لكل إدخال مطابق في ملف CSV، مما يُنشئ صوتًا مخصصًا لكل فيديو في القائمة. ندعم ما يصل إلى 20 متغيرًا قالبيًا لكل طلب. تأكد من تطابق عدد وأسماء هذه المتغيرات تمامًا بين نصك وملف CSV. نص متغير القالب لا يتأثر بحالة الأحرف. في حال عدم وجود أي متغير قالبي من ملف CSV، سيتم إرجاع خطأ. ستتلقى في الرد تفاصيل حول عدد مقاطع الفيديو الناجحة وتلك التي فشلت. استخدم 'id' من الرد للتحقق من حالة الطلب المجمع باستخدام bulk status API

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

طلبالرد

curl --request POST \
     --url 'https://api.immersive-fox.com/v1/bulk_requests/generate_video/' \
     --header 'X-Api-Key: <your-api-key>' \
     --header 'Content-Type: application/json' \
     --data { \
                "csv_id": 45 \
                "subtitles_flag": false \
                "video_name": "My First Video" \
                "configurations": [ \
                    { \
                        "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_number": 1, \
                        "scene_transition": "none", \
                        "audio_id": 2, \
                        "audio_service": "google_audio", \
                        "user_voice_speed": 1, \
                        "x_position": 0.604931, \
                        "y_position": 0.43101 \
                    } \
                ] \
            }

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