वीडियो सबटाइटल और वॉटरमार्क तथा इमेज वॉटरमार्क के लिए Video Eraser API
अपडेट · उत्पाद के उपयोग की प्रक्रिया की समीक्षा 550W AI Labs ने की है
550W डेवलपर API वास्तव में क्या करता है
550W डेवलपर API सर्वर को अधिकृत वीडियो सबटाइटल/टेक्स्ट या चुने हुए आयत के भीतर दिखने वाले वॉटरमार्क हटाने के कार्य भेजने देता है; यह इमेज वॉटरमार्क भी प्रोसेस करता है। API का उपयोग स्रोत सामग्री के अधिकार नहीं देता और तैयार नतीजों की जाँच ज़रूरी है।
वीडियो सबटाइटल और वॉटरमार्क प्रोसेस करना
वीडियो के लिए MP4 या MOV को /open/uploadVideo से अपलोड करें या /open/submitTask को सार्वजनिक videoUrl दें। अनुरोध में चौड़ाई, ऊँचाई, अवधि और संपादन का आयत दें। कार्य असिंक्रोनस होता है; /open/taskDetail या /open/taskList से स्थिति जाँचें।
इमेज से वॉटरमार्क हटाना
इमेज के लिए /open/removeImageWatermark अधिकतम 50 MB के JPG, PNG, BMP, WebP, AVIF, TIFF और SVG स्वीकार करता है। यह तैयार नतीजा या बाद में देखने के लिए कार्य लौटा सकता है। Eraser API लिंक से वीडियो डाउनलोड करके वॉटरमार्क हटाने की सुविधा नहीं देता; उत्पाद में इसका वादा न करें।
API का उपयोग केवल अधिकृत वीडियो टेक्स्ट और इमेज वॉटरमार्क के दस्तावेज़ित कार्यों में करें।
उत्पादन के लिए अनुरोध क्रम
हर अनुरोध में userNo और apiKey चाहिए। दोनों सर्वर पर रखें; ब्राउज़र या मोबाइल कोड में रखा कुंजी उपयोगकर्ता निकाल सकते हैं। पहले वीडियो अपलोड करें या सेवा द्वारा पहुँचे जा सकने वाला सार्वजनिक HTTP(S) पता दें।
| चरण | एंडपॉइंट | क्या सहेजें |
|---|---|---|
| अपलोड | /open/uploadVideo | videoUrl, coverUrl, width, height, duration |
| भेजें | /open/submitTask | taskId, Idempotency-Key / idempotencyKey, asset ID |
| स्थिति | /open/taskDetail or /open/taskList | status, cost, failCode, failReason, refundStatus |
| डिलीवरी | callbackUrl and resultUrl | स्वीकृत प्रति और समीक्षा रिकॉर्ड |
प्रमाणीकरण और अपलोड
/open/submitTask में width, height, duration और x1, y1, x2, y2 भेजें। Standard (mode=normal, डिफ़ॉल्ट) चयनित आयत के भीतर काम करता है। Protect (mode=protect) आयत के भीतर का हिस्सा बचाकर बाहर के हिस्से को संसाधित करता है; यह बेहतर गुणवत्ता का मोड नहीं है। removeAudio तभी लगाएँ जब प्रसंस्करण से पहले आवाज़ हटानी हो।
डुप्लिकेट से सुरक्षित कार्य भेजना
अधिकतम 128 अक्षरों का Idempotency-Key भेजें। कार्य भेजने के बाद कनेक्शन कटे तो उसी तार्किक कार्य के लिए वही कुंजी इस्तेमाल करें, ताकि दूसरा बिल योग्य कार्य न बने। taskId अपने एसेट ID के साथ सुरक्षित रखें।
नतीजा पाना और सत्यापन
असिंक्रोनस नतीजे के लिए सार्वजनिक HTTP(S) callbackUrl दें। अंतिम स्थिति का वेबहुक आते ही प्राप्ति स्वीकारें और /open/taskDetail से फिर सत्यापन करें। दोहराए गए वेबहुक सुरक्षित ढंग से संभालें; देरी की स्थिति में पोलिंग रखें।
सर्वर पर कुंजी, स्थिर Idempotency-Key, taskId और वेबहुक सत्यापन पुनः प्रयास को सुरक्षित बनाते हैं।
इनपुट सीमाएँ और गुणवत्ता जाँच
API की ये सीमाएँ ब्राउज़र वाले वीडियो कार्यप्रवाह से अलग हैं। कार्य भेजने से पहले फ़ाइल का प्रारूप, अवधि, आकार, बिट गहराई और HDR स्थिति जाँचें, ताकि असमर्थित सामग्री भुगतान वाले चरण में न पहुँचे।
क्रेडिट खर्च से पहले जाँचें
नतीजा टेक्स्ट के पीछे की गति पर निर्भर करता है। सपाट दीवार या आसमान अक्सर बाल, हाथ, पैटर्न, प्रतिबिंब और तेज कैमरा गति से आसान होते हैं। कठिन फ़ाइलों की समीक्षा सूची बनाएँ और सिर्फ थंबनेल नहीं, पूरी टाइमलाइन देखें।
कठिन वीडियो मनुष्य को दिखाएँ
इमेज कार्य सामान्य प्रारूपों को संभालते हैं; सफल कार्य की लागत मौजूदा API पृष्ठ पर जाँचें। मूल फ़ाइल सुरक्षित रखें और परिणाम को अलग प्रति मानें। वॉटरमार्क हटाने से कॉपीराइट या व्यावसायिक उपयोग की अनुमति नहीं मिलती।
असमर्थित इनपुट पहले रोकें और महत्वपूर्ण चलती जानकारी पर मानवीय समीक्षा रखें।
बिलिंग, विफलता और पुनः प्रयास
वीडियो सबटाइटल हटाने की लागत अवधि और रिज़ॉल्यूशन से तय होती है। वर्तमान दर 720p तक 1.3 क्रेडिट प्रति सेकंड और 720p से ऊपर 1080p तक 1.6 है। 30 सेकंड का वीडियो क्रमशः लगभग 39 या 48 क्रेडिट लेता है। बड़े समूह से पहले /open/queryCredits से शेष क्रेडिट जाँचें।
भेजने से पहले लागत का अनुमान
उत्तर में code और message होते हैं; कार्य में status और पूरा होने पर resultUrl होता है। विफल कार्य में failCode, failReason और refundStatus हो सकते हैं। अस्थायी नेटवर्क समस्या पर बढ़ती देरी से कोशिश करें, लेकिन गलत पैरामीटर, असमर्थित फ़ाइल या अपर्याप्त क्रेडिट ठीक किए बिना न दोहराएँ।
स्थिर त्रुटि फ़ील्ड संभालें
भेजने और पूरा होने का समय, विफलता दर, समीक्षा में अस्वीकृति और स्वीकृत फ़ाइल की लागत दर्ज करें। इससे पता चलता है कि स्वचालन सच में संपादकीय काम घटा रहा है या नहीं।
केवल सफल HTTP उत्तर नहीं, स्वीकृत फ़ाइल और वास्तविक लागत मापें।
चार चरणों में इंटीग्रेशन शुरू करें
डेवलपर पृष्ठ से API कुंजी बनाकर एक प्रतिनिधि वीडियो भेजें। फिर अपने उत्पाद में waiting, processing, success और failed स्थिति दिखाएँ। Idempotency-Key, वेबहुक और बैकअप पोलिंग जोड़ें। अंत में छोटा समूह चलाकर हर नतीजा जाँचें और फिर ही कार्यभार बढ़ाएँ।
बड़े पैमाने से पहले परीक्षण
विकास और उत्पादन की सेटिंग अलग रखें, उजागर कुंजी बदलें, मूल मीडिया तक पहुँच सीमित करें और नतीजों की हटाने की नीति बनाएँ। इसके बाद API को मीडिया लाइब्रेरी, CMS या स्थानीयकरण कतार से जोड़ें, लेकिन संपादकीय स्वीकृति बनाए रखें।
अक्सर पूछे जाने वाले सवाल
API से कौन से वीडियो कार्य भेज सकते हैं?
API अधिकृत वीडियो सबटाइटल/टेक्स्ट या दिखने वाले वॉटरमार्क क्षेत्र के कार्य अपलोड किए गए योग्य MP4/MOV या सार्वजनिक रूप से पहुँच योग्य videoUrl पर स्वीकार करता है; क्षेत्र के निर्देशांक देने होते हैं। यह सोशल मीडिया पोस्ट डाउनलोड करने का साधन नहीं है। इनपुट शर्तों के लिए मौजूदा API दस्तावेज़ देखें।
पोलिंग करें या वेबहुक इस्तेमाल करें?
सामान्य पूर्णता के लिए वेबहुक रखें और कार्य विवरण की पोलिंग बैकअप के रूप में। दोनों हैंडलर दोहराई डिलीवरी सहें।
टाइम-आउट के बाद दोहरे शुल्क से कैसे बचें?
कार्य बनाते समय स्थिर Idempotency-Key भेजें और उसी तार्किक कार्य के पुनः प्रयास में वही मान रखें।
वीडियो कार्य की बिलिंग कैसे होती है?
वर्तमान API पृष्ठ पर 720p तक 1.3 और उससे ऊपर 1080p तक 1.6 क्रेडिट प्रति सेकंड दिए हैं। अनुमान तय करने से पहले नवीनतम शर्तें जाँचें।
क्या API कुंजी फ़्रंटएंड कोड में रख सकते हैं?
नहीं। userNo और apiKey बैकएंड पर रखें और अधिकृत अनुरोध अपने सर्वर से भेजें।