बल्क वीडियो अनुरोध

यह API गाइड बल्क अनुरोध जनरेशन का अवलोकन प्रदान करता है।

---

बल्क वीडियो अनुरोध

बल्क अनुरोध आपको उपयोगकर्ता-विशिष्ट डेटा वाली CSV फ़ाइल का उपयोग करके एक बार में कई व्यक्तिगत वीडियो फ़ाइलें बनाने की अनुमति देता है। प्रत्येक ऑडियो को व्यक्तिगत रूप से बनाने के बजाय, आप CSV में नाम और कंपनी विवरण जैसे विभिन्न फ़ील्ड इनपुट कर सकते हैं और सिस्टम स्वचालित रूप से प्रत्येक प्रविष्टि के लिए अनुकूलित ऑडियो उत्पन्न करेगा। 🦊

मान लें कि आप कई उपयोगकर्ताओं के लिए वैयक्तिकृत ऑडियो फ़ाइलें बनाना चाहते हैं। आपकी CSV फ़ाइल में निम्नलिखित डेटा है:

पहला नाम	कंपनी का नाम
जॉन	एक्मे कॉर्प
जेन	बीटा लिमिटेड

यह आपको अपने CSV में प्रत्येक उपयोगकर्ता के लिए अनुकूलित ऑडियो फ़ाइलें बनाने की अनुमति देता है, जिससे बल्क अनुरोध कुशल और वैयक्तिकृत दोनों बन जाते हैं।

त्वरित प्रारंभ

आइए आगे बढ़ें और अपने कस्टम कॉन्फ़िगरेशन के साथ बल्क अनुरोध बनाने का तरीका जानें।

बल्क अनुरोध बनाना

बल्क अनुरोध बनाने के लिए, निम्न API अनुरोध का उपयोग करें। यह आपको बल्क अनुरोध बनाने के लिए ऑडियो टेक्स्ट, अवतार और पृष्ठभूमि सहित विभिन्न सेटिंग्स को परिभाषित करने देता है। अपनी ज़रूरतों के हिसाब से पैरामीटर कस्टमाइज़ करें। यदि आपके पास बल्क टेम्पलेट है, तो बल्क अनुरोध बनाने के लिए उसका उपयोग करने के लिए बल्क टेम्पलेट API बनाएँ का उपयोग करें।

आप ऑडियो लिस्टिंग API से 'audio_id' और 'audio_service' प्राप्त कर सकते हैं और csv लिस्टिंग API से "csv_id" प्राप्त कर सकते हैं।

आप 'audio_text' के भीतर '{{}}' प्रारूप में मैक्रोज़ का उपयोग कर सकते हैं, जिसे आपके द्वारा प्रदान की गई CSV फ़ाइल से मानों द्वारा गतिशील रूप से प्रतिस्थापित किया जाएगा। उदाहरण के लिए, यदि आप अपने टेक्स्ट में '{{First Name}}' शामिल करते हैं, तो इसे CSV में प्रत्येक संगत प्रविष्टि के लिए "जॉन" और "स्मिथ" जैसे नामों से बदल दिया जाएगा, जिससे सूची में प्रत्येक वीडियो के लिए वैयक्तिकृत ऑडियो बनाया जाएगा। हम प्रति अनुरोध 20 टेम्पलेट वैरिएबल तक का समर्थन करते हैं। सुनिश्चित करें कि इन चरों की संख्या और नाम आपके टेक्स्ट और CSV फ़ाइल के बीच बिल्कुल मेल खाते हों। टेम्प्लेट चर टेक्स्ट केस केस-सेंसिटिव नहीं है। यदि CSV से कोई टेम्प्लेट चर गायब है, तो एक त्रुटि लौटाई जाएगी।

प्रतिक्रिया में, आपको सफल वीडियो की संख्या और विफल होने वाले किसी भी वीडियो के बारे में विवरण प्राप्त होगा। बल्क स्टेटस API का उपयोग करके बल्क अनुरोध की स्थिति की जाँच करने के लिए प्रतिक्रिया से 'id' का उपयोग करें

• '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": []
}