"वीडियो अवतार" अनुभाग में वेबहुक: वीडियो तैयार होने पर आपके सर्वर को सूचना
अनुभाग में वेबहुक "वीडियो अवतार" यह पता लगाने का एक तरीका है कि वीडियो तैयार है, पृष्ठ को मैन्युअल रूप से ताज़ा किए बिना: जैसे ही वीडियो पूरा हो जाता है, आपके सर्वर के पते पर एक POST अनुरोध भेजा जाता है, और आपका सर्वर स्वयं निर्णय लेता है कि आगे क्या करना है - डेटाबेस के लिए लिंक लिखें, क्लाइंट को फ़ाइल भेजें, या अगला चरण शुरू करें। टैब की आवश्यकता उन लोगों को होती है जो बैचों में वीडियो बनाते हैं या अवतारों की पीढ़ी को अपने उत्पाद में एकीकृत करते हैं: अंतहीन "तैयार या अभी तक नहीं" जांच के बजाय, एक छोटी अधिसूचना बिल्कुल सही समय पर आती है।
यह आख़िर क्यों आवश्यक है?
किसी वीडियो को रेंडर करना कोई त्वरित कार्रवाई नहीं है, और खुले टैब में इसके लिए प्रतीक्षा करने का कोई मतलब नहीं है। प्लेटफ़ॉर्म माप दिनांक 09/07/2026 के अनुसार, 1080पी में पांच सेकंड के क्लिंग 3.0 वीडियो को औसतन 115 सेकंड माना जाता है, और 95% मामलों में यह 165 में फिट बैठता है। सोरा 2 के लिए, उसी कार्य में औसतन लगभग 145 सेकंड लगते हैं। यदि आप हर कुछ सेकंड में स्थिति की जांच करते हैं, तो एक वीडियो में दर्जनों खाली अनुरोध दिखाई देते हैं; वेबहुक केवल एक बार आता है - जब परिणाम वास्तव में प्रकट होता है।
वॉल्यूम भी अपने लिए बोलता है. प्लेटफ़ॉर्म के जनरेशन लॉग के अनुसार, 30 दिनों (3 सितंबर - 2 अक्टूबर, 2026) में, 3,292 वीडियो कार्य शुरू हुए, जिनमें से 2,369 सफलतापूर्वक पूरे हुए। वीडियो को पृष्ठभूमि में गिना जाता है और अलग-अलग समय पर समाप्त होता है - इसे मैन्युअल रूप से ट्रैक नहीं किया जा सकता है, और एक साफ-सुथरा अधिसूचना हैंडलर समस्या को स्वयं हल कर देता है।
"वेबहुक" टैब क्या करता है?
यह सब जादू के बिना, सूचनाएं पहुंचाने के बारे में है। आप एक पता पंजीकृत करते हैं, चुनते हैं कि किस ईवेंट की सदस्यता लेनी है, और एक सदस्यता रहस्य प्राप्त करें। पंजीकृत समापन बिंदुओं की सूची वहीं संग्रहीत की जाती है: आप पता, चयनित घटनाएं, स्थिति और देख सकते हैं कि समापन बिंदु में कोई रहस्य है या नहीं। रहस्य को फिर से जारी किया जा सकता है (पुराना तुरंत काम करना बंद कर देगा) या समापन बिंदु को पूरी तरह से हटाया जा सकता है।
घटना केवल आपके वीडियो से आती है: किसी और का वीडियो बाहर नहीं जाएगा, भले ही उसे उसी क्षण गिना गया हो। वितरित ईवेंट का एक लॉग भी है - यह जांचना सुविधाजनक है कि कुछ वास्तव में आपके सर्वर तक पहुंचा है या नहीं।
शुरुआत कैसे करें - चरण दर चरण
- अनुभाग खोलें "वीडियो अवतार" और सीधे पते पर वेबहुक पैनल /ru/evatars?tab=webhooks.
- अपने खाते में लॉग इन करें: सेटिंग मेहमानों के लिए उपलब्ध नहीं है; क्लिक करने पर एक लॉगिन विंडो खुलेगी।
- "एंडपॉइंट एड्रेस" फ़ील्ड में, अपने सर्वर का सार्वजनिक HTTPS पता दर्ज करें, उदाहरण के लिए https://example.com/avatar-webhook। HTTP काम नहीं करेगा - डिलीवरी और हस्ताक्षर एक सुरक्षित चैनल के लिए डिज़ाइन किए गए हैं।
- आवश्यक घटनाओं को चिह्नित करें. यदि आप कुछ भी नहीं चुनते हैं, तो आपको एक ही बार में सभी ईवेंट की सदस्यता दे दी जाएगी।
- "एंडपॉइंट जोड़ें" पर क्लिक करें। निर्माण के तुरंत बाद, सदस्यता रहस्य दिखाई देगा - इसे कॉपी करें और अपने लिए सहेजें: इसे दोबारा प्रदर्शित नहीं किया जाएगा।
- यदि आपके पास अभी तक अपना सर्वर नहीं है, तो "हमारे रिसीवर को प्रतिस्थापित करें" पर क्लिक करें - फिर सूचनाएं सीधे टैब में वितरित ईवेंट के लॉग में जमा हो जाएंगी।
कैसे सुनिश्चित करें कि अनुरोध हमारी ओर से है और नकली नहीं है
प्रत्येक अनुरोध के साथ एक हस्ताक्षर शीर्षलेख होता है - यह HMAC-SHA256 है, जिसकी गणना आपके रहस्य के रूप में अनुरोध के मूल भाग से की जाती है। अपनी ओर से, उसी हस्ताक्षर को गिनें और तुलना करें: यदि यह मेल नहीं खाता है, तो हम अनुरोध को खारिज कर देते हैं। हमारा रिसीवर बिल्कुल यही करता है और गलत हस्ताक्षर पर 401 के साथ प्रतिक्रिया करता है। रहस्य को सर्वर पर, पर्यावरण चर में रखें, न कि क्लाइंट कोड में।
अनुरोध में क्या आता है
इवेंट प्रकार और इकाई डेटा के साथ मुख्य भाग सादा JSON है। उदाहरण के लिए, एक तैयार वीडियो के लिए, यह वीडियो पहचानकर्ता के साथ BLK0 इवेंट है। उपलब्ध ईवेंट प्रकारों की पूरी सूची टैब में दिखाई गई है: आप इसे क्रमबद्ध कर सकते हैं और केवल वही छोड़ सकते हैं जिसकी आपकी सेवा को वास्तव में आवश्यकता है।
इसकी कीमत कितनी होती है
समापन बिंदु पंजीकरण, गुप्त पुन: रिलीज़, विलोपन और ईवेंट लॉग टोकन को नहीं लिखते हैं - यह अधिसूचना सेटिंग है, पीढ़ी नहीं। टोकन केवल वीडियो पर ही खर्च किए जाते हैं: टोकन में कीमत लॉन्च से पहले दिखाई देती है, और यदि कार्य विफल हो जाता है, तो जो लिखा गया था वह वापस कर दिया जाता है। कोई सदस्यता नहीं है: नए उपयोगकर्ताओं को उनके पहले परीक्षणों के लिए शुरुआती टोकन दिए जाते हैं।
किसके साथ गठबंधन करना है
- "बैच कार्य" — एक कार्य के साथ दर्जनों वीडियो लॉन्च करना; एक वेबहुक मैन्युअल तत्परता नियंत्रण की आवश्यकता को समाप्त कर देगा।
- "मीडिया लाइब्रेरी" - स्रोत कोड और तैयार फ़ाइलों का भंडारण।
- "वीडियो अनुवाद" और "क्लिप काटना" - पीढ़ी दर पीढ़ी अगले चरण।
अक्सर पूछे जाने वाले प्रश्नों
वेबहुक के लिए कौन सा पता उपयुक्त है?
केवल सार्वजनिक HTTPS. स्थानीय पते और HTTP स्वीकार नहीं किए जाते हैं: अधिसूचना को एक सुरक्षित चैनल पर जाना चाहिए, और आपका सर्वर बाहर से पहुंच योग्य होना चाहिए।
क्या सर्वर न होने पर सूचनाएं प्राप्त करना संभव है?
हाँ। "हमारे रिसीवर को प्रतिस्थापित करें" पर क्लिक करें - ईवेंट टैब में "डिलीवर किए गए ईवेंट" लॉग में जमा हो जाएंगे, उन्हें आपके बैकएंड के बिना देखा जा सकता है।
अगर हस्ताक्षर मेल नहीं खाते तो क्या करें?
जांचें कि आप HMAC-SHA256 को कच्चे अनुरोध निकाय से पढ़ रहे हैं (और पार्स किए गए JSON से नहीं) और आप वर्तमान रहस्य का उपयोग कर रहे हैं: पुनः जारी करने के बाद, पुराना तुरंत काम करना बंद कर देता है।
क्या इसका भुगतान किया गया है?
वेबहुक सेट करने से टोकन बंद नहीं होते हैं। टोकन केवल वीडियो निर्माण पर खर्च किए जाते हैं - उनकी कीमत लॉन्च से पहले दिखाई देती है; कोई सदस्यता नहीं है, नए उपयोगकर्ताओं को शुरुआती टोकन दिए जाते हैं।