टेम्प्लेट प्रबंधित करना

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

---

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

त्वरित आरंभ

आइए गोता लगाएँ और पता लगाएं कि टेम्पलेट कैसे बनाएं और अपने टेम्पलेट्स को सूचीबद्ध करें, ताकि आप बाद में उनका उपयोग करके कुशलतापूर्वक बल्क वीडियो बना सकें।

टेम्पलेट बनाना

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

अनुरोधप्रतिक्रिया

curl --request POST  \
     --url 'https://api.immersive-fox.com/v1/template/create_bulk_template/'  \
     --header 'X-Api-Key: <your-api-key>'  \
     --header 'Content-Type: application/json'  \
     --data { \
         "csv_id": 45, \
         "template_name": "My new template", \
         "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": 1142,
    "project_name": "My new template",
    "csv_id": 45,
    "user": 31,
}

AI के साथ टेम्पलेट

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

अनुरोधप्रतिक्रिया

curl --request POST  \
     --url 'https://api.immersive-fox.com/v1/template/generate_bulk_template_with_ai/'  \
     --header 'X-Api-Key: <your-api-key>'  \
     --header 'Content-Type: application/json'  \
     --data { \
         "avatar_gender": "female", # male / female \
         "template_name": "Project_01", \
         "target_audience" : "Subscribers of Spotify", \
         "description" : "Tell our users that their subscription is going to finish soon", \
         "main_language" : "English", \
         "goal" : "Renew Subscription", \
         "allow_third_party_ml_models": true, \
         "length": "long", # short / medium / long \
         "optional_params_for_scripts": ["person_name", "subscription_type", "subscription_charges"] \
     }

{
    "id": 1142,
    "project_name": "Project_01",
    "user": 31,
}

लिस्टिंग टेम्पलेट

उपयोगकर्ता द्वारा बनाए गए सभी टेम्पलेट्स को सूचीबद्ध करने के लिए, निम्न API अनुरोध का उपयोग करें। यह सभी टेम्पलेट्स का विवरण लौटाता है, जिससे आप उनकी समीक्षा और प्रबंधन कर सकते हैं। एक बार जब आपके पास टेम्पलेट्स हो जाते हैं, तो आप इस टेम्पलेट का उपयोग करके बल्क अनुरोध उत्पन्न करने के लिए create bulk requests में इनमें से किसी भी टेम्पलेट से 'id' का उपयोग 'template_id' के रूप में कर सकते हैं।

अनुरोधप्रतिक्रिया

curl --request GET  \
     --url 'https://api.immersive-fox.com/v1/template/bulk_templates'  \
     --header 'X-Api-Key: <your-api-key>'  \
     --header 'Content-Type: application/json'

[
    {
        "id": 1112,
        "project_name": "My old template",
        "csv_id": 41,
        "user": 31
    },
    {
        "id": 1142,
        "project_name": "My new template",
        "csv_id": 45,
        "user": 31
    }
]

टेम्पलेट विवरण प्राप्त

करें किसी विशिष्ट टेम्पलेट का विवरण प्राप्त करने के लिए, निम्न API अनुरोध का उपयोग करें। यह चयनित टेम्पलेट के बारे में जानकारी प्रदान करता है, जिससे आप बल्क अनुरोध जनरेशन से पहले कॉन्फ़िगरेशन देख सकते हैं। एक बार जब आपके पास टेम्पलेट विवरण हो जाता है, तो आप इस टेम्पलेट का उपयोग करके बल्क अनुरोध जनरेट करने के लिए create bulk requests में 'id' को 'template_id' के रूप में उपयोग कर सकते हैं।

अनुरोधप्रतिक्रिया

curl --request GET  \
     --url 'https://api.immersive-fox.com/v1/template/bulk_template/<template_id>'  \
     --header 'X-Api-Key: <your-api-key>'  \
     --header 'Content-Type: application/json'

{
    "csv_id": 47,
    "template_name": "My new template",
    "configurations": [ {
    "audio_text": "Hi, My name is {{First Name}}",
    "avatar": 223,
    "avatar_size": 75,
    "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.431010,
}