ElevenAPIDubbing

डबिंग प्रोजेक्ट बनाएं

अपलोड की गई फ़ाइल (`file`) या सोर्स URL (`source_url`) से डबिंग प्रोजेक्ट बनाएं। सोर्स फ़ेच होने से पहले ही, प्रोजेक्ट रिकॉर्ड बनते ही रिस्पॉन्स लौटता है: प्रोजेक्ट `queued` से शुरू होता है और सोर्स का ट्रांसक्रिप्शन पूरा होने पर `ready` हो जाता है। हर इच्छित भाषा के लिए इसमें एक भाषा टारगेट जोड़ें या यहाँ पहले टारगेट को क्यू में डालने के लिए `target_language` दें। प्रोजेक्ट बनाने पर कम-से-कम एक भाषा का शुल्क लगता है: कोई आउटपुट मौजूद होने से पहले ही प्रोजेक्ट बनाते समय कम-से-कम एक भाषा की डबिंग का शुल्क लिया जाता है। यह शुल्क पहले भाषा टारगेट के लिए अग्रिम भुगतान है — आपके द्वारा जोड़ा गया पहला टारगेट, या `target_language` से क्यू किया गया टारगेट, इसे इस्तेमाल करता है — और हर अतिरिक्त भाषा का अलग से शुल्क लिया जाता है। लंबे सोर्स की तैयारी में कई मिनट लग सकते हैं, इसलिए प्रोजेक्ट के `ready` या `failed` होने पर सूचना पाने के लिए पोलिंग के बजाय `webhook_ids` पास करने की सलाह दी जाती है।

Headers

xi-api-keystringOptional

Request

This endpoint expects a multipart form with multiple files.
filefileOptional

डब करने के लिए स्रोत मीडिया फ़ाइल: अधिकतम 3 GiB की ऑडियो या वीडियो फ़ाइल। यह या source_url दें, दोनों नहीं।

source_urlstring or nullOptional
सार्वजनिक HTTP(S) URL, जिससे सर्वर-साइड पर source media फ़ेच किया जाता है और जिस पर अपलोड जैसी ही आकार व फ़ॉर्मैट सीमाएं लागू होती हैं। यह या `file` दें, दोनों नहीं।
referencestring or nullOptional
आपकी तरफ़ project की पहचान के लिए वैकल्पिक free-form string (अधिकतम 500 characters)। इसे ज्यों-का-त्यों संग्रहीत और वापस भेजा जाता है; इससे dub प्रभावित नहीं होता।
source_languagestring or nullOptional
सोर्स मीडिया का BCP-47 भाषा टैग; यह ट्रांसक्रिप्शन मॉडल द्वारा समर्थित भाषा होनी चाहिए। क्षेत्र या स्क्रिप्ट का कोई भी सबटैग अनदेखा किया जाता है, क्योंकि ट्रांसक्रिप्शन प्रति-भाषा होता है। ऑटो-डिटेक्ट के लिए इसे छोड़ दें।
model_idenum or string or nullOptional
डबिंग मॉडल (`dubbing_v1` या `dubbing_v2`) जिससे इस प्रोजेक्ट के हर भाषा टारगेट को डब किया जाता है। डिफ़ॉल्ट `dubbing_v2` है। इसे बनाते समय तय किया जाता है — सोर्स इस मॉडल के लिए तैयार किया जाता है, इसलिए बाद में न प्रोजेक्ट और न ही कोई व्यक्तिगत टारगेट इसे बदल सकता है।
keytermslist of stringsOptional
ट्रांसक्रिप्शन और अनुवाद को प्राथमिकता देने के लिए मुख्य शब्द (जैसे, प्रोडक्ट या ब्रांड नाम)। अधिकतम 1,000 शब्द; हर शब्द में अधिकतम 50 वर्ण और 5 शब्द; `<>{}[]\` वर्णों की अनुमति नहीं है। शब्दों से अतिरिक्त स्पेस हटाए जाते हैं और डुप्लिकेट हटाए जाते हैं। हर शब्द के लिए फ़ील्ड को एक बार दोहराएं या एक अकेला JSON array दें।
webhook_idslist of stringsOptional
प्रोजेक्ट की प्रगति के दौरान सूचित किए जाने वाले 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](https://elevenlabs.io/docs/eleven-api/resources/webhooks) देखें। हर ID के लिए फ़ील्ड एक बार दोहराएं या एकल JSON array अथवा कॉमा से अलग की गई स्ट्रिंग पास करें। डिलीवरी best-effort है और दोहराई जा सकती है, इसलिए हम इवेंट को idempotently हैंडल करने की सलाह देते हैं।
target_languagestring or nullOptional
वैकल्पिक shortcut: इस BCP-47 language में एक language target भी बनाएं, जिसे project तैयार होने पर शुरू करने के लिए queue किया जाता है — यह project बनाने और फिर एक language target बनाने के बराबर है। यह [डबिंग मॉडल द्वारा समर्थित भाषाओं](https://elevenlabs.io/docs/help-center/product/dubbing/which-languages-are-supported-in-dubbing) में से एक होनी चाहिए और region-qualified tag समर्थित dialects में से एक होना चाहिए। यह पहला language target है, इसलिए यह project के न्यूनतम charge का उपयोग करता है, उसमें अतिरिक्त नहीं जुड़ता। इसकी ID `language_ids` में लौटाई जाती है।
transcriptfileOptional
केवल Enterprise के लिए। स्रोत को ट्रांसक्राइब करने के बजाय इस्तेमाल करने के लिए वैकल्पिक JSON ट्रांसक्रिप्ट: एक `{"segments": [...]}` दस्तावेज़, जिसमें अधिकतम 20,000 सेगमेंट और 4 MiB हो सकते हैं। सेगमेंट फ़ील्ड और उनकी सीमाओं के लिए [अपना ट्रांसक्रिप्ट लाएं](https://elevenlabs.io/docs/eleven-api/guides/how-to/dubbing/bring-your-own-transcript) देखें। ट्रांसक्रिप्ट दिए जाने पर `source_language` आवश्यक है। अगर किसी सेगमेंट में `translation` है, तो `target_language` आवश्यक है और हर सेगमेंट में अनुवाद होना चाहिए; ये अनुवाद `target_language` के ज़रिए बनाए गए टारगेट को आरंभिक डेटा देते हैं, जो फिर मशीन अनुवाद को छोड़ देता है।

Response

सफल रिस्पॉन्स

project_idstring

डबिंग प्रोजेक्ट का विशिष्ट पहचानकर्ता।

statusenum

प्रोजेक्ट की लाइफ़साइकल स्थिति: सोर्स उठाए जाने से पहले queued, ट्रांसक्राइब होने के दौरान preparing, ट्रांसक्रिप्शन पूरा होने और भाषा टारगेट शुरू हो सकने पर ready, या failed। किसी प्रोजेक्ट की स्थिति कभी processing के रूप में रिपोर्ट नहीं होती — यह मान भाषा टारगेट के लिए है।

Allowed values:
revisioninteger

सोर्स ट्रांसक्रिप्ट संपादित होने पर बढ़ने वाला मोनोटोनिक काउंटर (सेगमेंट जोड़ना/संपादित करना/हटाना)।

created_atstringformat: "date-time"

प्रोजेक्ट कब बनाया गया था।

updated_atstringformat: "date-time"

प्रोजेक्ट को आखिरी बार कब अपडेट किया गया था।

referencestring or nullOptional

प्रोजेक्ट बनाते समय reference के रूप में दी गई आपकी मुक्त-रूप स्ट्रिंग, या अगर आपने कुछ नहीं दिया है तो null।

source_languagestring or nullOptional

सोर्स मीडिया का BCP-47 भाषा टैग (ऑटो-डिटेक्ट होने पर null)।

model_idstring or nullOptional

डबिंग मॉडल जिससे इस प्रोजेक्ट के हर भाषा टारगेट को डब किया जाता है। इसे बनाते समय तय किया जाता है और हर भाषा के लिए अलग से नहीं चुना जा सकता।

mediaobject or nullOptional

source media metadata, source के fetch और decode होने पर भरा जाता है (create के तुरंत बाद, project के ready होने से पहले); तब तक null।

language_idslist of stringsOptionalDefaults to []

इस प्रोजेक्ट के अंतर्गत भाषा टारगेट के पहचानकर्ता। एकल प्रोजेक्ट पाने पर और target_language द्वारा कोई टारगेट बनाए जाने पर यह भरा जाता है। सूची रिस्पॉन्स में यह हमेशा खाली होता है — इसके बजाय प्रोजेक्ट के भाषा टारगेट सूचीबद्ध करें।

webhook_idslist of stringsOptionalDefaults to []

इस प्रोजेक्ट और इसकी भाषाओं के ready, completed या failed होने पर सूचित किए जाने वाले workspace webhooks की ID।

errorobject or nullOptional

प्रोजेक्ट क्यों विफल हुआ; status के failed होने तक null। उन कुछ प्रोजेक्ट्स के लिए भी null, जो विफलता रिपोर्टिंग शुरू होने से पहले विफल हुए थे।

warningslist of objectsOptional

सोर्स तैयार करते समय उठी गैर-गंभीर स्थितियाँ; कोई न होने पर खाली। यह नवीनतम तैयारी को दर्शाता है। किसी खास भाषा की डबिंग के दौरान उठी स्थितियाँ इसके बजाय उस भाषा पर रिपोर्ट होती हैं।

Errors

422
Unprocessable Entity Error