डबिंग प्रोजेक्ट बनाएं
अपलोड की गई फ़ाइल (file) या सोर्स URL (source_url) से डबिंग प्रोजेक्ट बनाएं।
सोर्स फ़ेच होने से पहले ही, प्रोजेक्ट रिकॉर्ड बनते ही रिस्पॉन्स लौटता है: प्रोजेक्ट queued से शुरू होता है और सोर्स का ट्रांसक्रिप्शन पूरा होने पर ready हो जाता है। हर इच्छित भाषा के लिए इसमें एक भाषा टारगेट जोड़ें या यहाँ पहले टारगेट को क्यू में डालने के लिए target_language दें।
प्रोजेक्ट बनाने पर कम-से-कम एक भाषा का शुल्क लगता है: कोई आउटपुट मौजूद होने से पहले ही प्रोजेक्ट बनाते समय कम-से-कम एक भाषा की डबिंग का शुल्क लिया जाता है। यह शुल्क पहले भाषा टारगेट के लिए अग्रिम भुगतान है — आपके द्वारा जोड़ा गया पहला टारगेट, या target_language से क्यू किया गया टारगेट, इसे इस्तेमाल करता है — और हर अतिरिक्त भाषा का अलग से शुल्क लिया जाता है।
लंबे सोर्स की तैयारी में कई मिनट लग सकते हैं, इसलिए प्रोजेक्ट के ready या failed होने पर सूचना पाने के लिए पोलिंग के बजाय webhook_ids पास करने की सलाह दी जाती है।
हेडर
अनुरोध
डब करने के लिए स्रोत मीडिया फ़ाइल: अधिकतम 3 GiB की ऑडियो या वीडियो फ़ाइल। यह या source_url दें, दोनों नहीं।
सार्वजनिक HTTP(S) URL, जिससे सर्वर-साइड पर source media फ़ेच किया जाता है और जिस पर अपलोड जैसी ही आकार व फ़ॉर्मैट सीमाएं लागू होती हैं। यह या file दें, दोनों नहीं।
आपकी तरफ़ project की पहचान के लिए वैकल्पिक free-form string (अधिकतम 500 characters)। इसे ज्यों-का-त्यों संग्रहीत और वापस भेजा जाता है; इससे dub प्रभावित नहीं होता।
सोर्स मीडिया का BCP-47 भाषा टैग; यह ट्रांसक्रिप्शन मॉडल द्वारा समर्थित भाषा होनी चाहिए। क्षेत्र या स्क्रिप्ट का कोई भी सबटैग अनदेखा किया जाता है, क्योंकि ट्रांसक्रिप्शन प्रति-भाषा होता है। ऑटो-डिटेक्ट के लिए इसे छोड़ दें।
डबिंग मॉडल (dubbing_v1 या dubbing_v2) जिससे इस प्रोजेक्ट के हर भाषा टारगेट को डब किया जाता है। डिफ़ॉल्ट dubbing_v2 है। इसे बनाते समय तय किया जाता है — सोर्स इस मॉडल के लिए तैयार किया जाता है, इसलिए बाद में न प्रोजेक्ट और न ही कोई व्यक्तिगत टारगेट इसे बदल सकता है।
ट्रांसक्रिप्शन और अनुवाद को प्राथमिकता देने के लिए मुख्य शब्द (जैसे, प्रोडक्ट या ब्रांड नाम)। अधिकतम 1,000 शब्द; हर शब्द में अधिकतम 50 वर्ण और 5 शब्द; <>{}[]\ वर्णों की अनुमति नहीं है। शब्दों से अतिरिक्त स्पेस हटाए जाते हैं और डुप्लिकेट हटाए जाते हैं। हर शब्द के लिए फ़ील्ड को एक बार दोहराएं या एक अकेला JSON array दें।
प्रोजेक्ट की प्रगति के दौरान सूचित किए जाने वाले workspace webhooks की ID — polling का विकल्प और हमारी सिफ़ारिश। हर webhook को प्रोजेक्ट के लिए dubbing_project_ready या dubbing_project_failed इवेंट और उसके अंतर्गत हर भाषा के लिए dubbing_language_completed या dubbing_language_failed इवेंट मिलता है; dubbing_language_completed में आउटपुट डाउनलोड URLs होते हैं। अधिकतम 3 ID, जिनमें से हर एक आपके workspace में पहले से कॉन्फ़िगर हो — इसे बनाने और इसके सिग्नेचर की पुष्टि करने का तरीका जानने के लिए Webhooks देखें। हर ID के लिए फ़ील्ड एक बार दोहराएं या एकल JSON array अथवा कॉमा से अलग की गई स्ट्रिंग पास करें। डिलीवरी best-effort है और दोहराई जा सकती है, इसलिए हम इवेंट को idempotently हैंडल करने की सलाह देते हैं।
वैकल्पिक shortcut: इस BCP-47 language में एक language target भी बनाएं, जिसे project तैयार होने पर शुरू करने के लिए queue किया जाता है — यह project बनाने और फिर एक language target बनाने के बराबर है। यह डबिंग मॉडल द्वारा समर्थित भाषाओं में से एक होनी चाहिए और region-qualified tag समर्थित dialects में से एक होना चाहिए। यह पहला language target है, इसलिए यह project के न्यूनतम charge का उपयोग करता है, उसमें अतिरिक्त नहीं जुड़ता। इसकी ID language_ids में लौटाई जाती है।
केवल Enterprise के लिए। स्रोत को ट्रांसक्राइब करने के बजाय इस्तेमाल करने के लिए वैकल्पिक JSON ट्रांसक्रिप्ट: एक {"segments": [...]} दस्तावेज़, जिसमें अधिकतम 20,000 सेगमेंट और 4 MiB हो सकते हैं। सेगमेंट फ़ील्ड और उनकी सीमाओं के लिए अपना ट्रांसक्रिप्ट लाएं देखें। ट्रांसक्रिप्ट दिए जाने पर source_language आवश्यक है। अगर किसी सेगमेंट में translation है, तो target_language आवश्यक है और हर सेगमेंट में अनुवाद होना चाहिए; ये अनुवाद target_language के ज़रिए बनाए गए टारगेट को आरंभिक डेटा देते हैं, जो फिर मशीन अनुवाद को छोड़ देता है।
रिस्पॉन्स
सफल रिस्पॉन्स
डबिंग प्रोजेक्ट का विशिष्ट पहचानकर्ता।
प्रोजेक्ट की लाइफ़साइकल स्थिति: सोर्स उठाए जाने से पहले queued, ट्रांसक्राइब होने के दौरान preparing, ट्रांसक्रिप्शन पूरा होने और भाषा टारगेट शुरू हो सकने पर ready, या failed। किसी प्रोजेक्ट की स्थिति कभी processing के रूप में रिपोर्ट नहीं होती — यह मान भाषा टारगेट के लिए है।
सोर्स ट्रांसक्रिप्ट संपादित होने पर बढ़ने वाला मोनोटोनिक काउंटर (सेगमेंट जोड़ना/संपादित करना/हटाना)।
प्रोजेक्ट कब बनाया गया था।
प्रोजेक्ट को आखिरी बार कब अपडेट किया गया था।
प्रोजेक्ट बनाते समय reference के रूप में दी गई आपकी मुक्त-रूप स्ट्रिंग, या अगर आपने कुछ नहीं दिया है तो null।
सोर्स मीडिया का BCP-47 भाषा टैग (ऑटो-डिटेक्ट होने पर null)।
डबिंग मॉडल जिससे इस प्रोजेक्ट के हर भाषा टारगेट को डब किया जाता है। इसे बनाते समय तय किया जाता है और हर भाषा के लिए अलग से नहीं चुना जा सकता।
source media metadata, source के fetch और decode होने पर भरा जाता है (create के तुरंत बाद, project के ready होने से पहले); तब तक null।
इस प्रोजेक्ट के अंतर्गत भाषा टारगेट के पहचानकर्ता। एकल प्रोजेक्ट पाने पर और target_language द्वारा कोई टारगेट बनाए जाने पर यह भरा जाता है। सूची रिस्पॉन्स में यह हमेशा खाली होता है — इसके बजाय प्रोजेक्ट के भाषा टारगेट सूचीबद्ध करें।
इस प्रोजेक्ट और इसकी भाषाओं के ready, completed या failed होने पर सूचित किए जाने वाले workspace webhooks की ID।
प्रोजेक्ट क्यों विफल हुआ; status के failed होने तक null। उन कुछ प्रोजेक्ट्स के लिए भी null, जो विफलता रिपोर्टिंग शुरू होने से पहले विफल हुए थे।
सोर्स तैयार करते समय उठी गैर-गंभीर स्थितियाँ; कोई न होने पर खाली। यह नवीनतम तैयारी को दर्शाता है। किसी खास भाषा की डबिंग के दौरान उठी स्थितियाँ इसके बजाय उस भाषा पर रिपोर्ट होती हैं।