आपको इस सप्ताह एक YouTube वीडियो का एक साफ ट्रांसक्रिप्ट चाहिए जिसे आप अनुक्रमित, संक्षेपित, उपशीर्षक या अपनी पाइपलाइन में डाल सकते हैं। इस गाइड के अंत तक आप एक वास्तविक एंडपॉइंट को कॉल करेंगे जो एक दिए गए वीडियो आईडी के लिए समय-कोडित टेक्स्ट की पंक्तियाँ लौटाता है, और आपके पास कॉपी-पेस्ट करने योग्य कोड होगा जिसे आप अपने ऐप या ऑटोमेशन में डाल सकते हैं।
YouTube सब एक्सट्रैक्टर API के साथ आप क्या बनाएंगे
Zyla API Hub YouTube सब एक्सट्रैक्टर API की मेज़बानी करता है, जो एक YouTube वीडियो के टेक्स्ट ट्रांसक्रिप्ट को कैप्शन प्रविष्टियों के अनुक्रम के रूप में लौटाता है। प्रत्येक प्रविष्टि में टेक्स्ट और समय मेटाडेटा शामिल होता है जिसका उपयोग आप कैप्शन को रेंडर करने, संक्षेपों को संरेखित करने, या वीडियो में किसी क्षण के लिए एंकर-खोज परिणामों को संरेखित करने के लिए कर सकते हैं।
आम उपयोगों में शामिल हैं:
- समय संरेखण के साथ स्वचालित उपशीर्षक और बंद कैप्शन उत्पन्न करना।
- लंबे वीडियो सामग्री के खोज योग्य अनुक्रमणिका बनाना।
- संक्षेपणकर्ताओं, एम्बेडिंग पाइपलाइनों, या मॉडरेशन उपकरणों को ट्रांसक्रिप्ट फीड करना।
- ट्रांसक्रिप्ट ऑफसेट के आधार पर अपने ऐप में "जंप-टू" लिंक बनाना।
सब कुछ एक ही API कुंजी और Zyla API Hub के भीतर एक सदस्यता पर चलता है, जो श्रेणियों में 10,000 से अधिक सार्वजनिक APIs को एकत्र करता है। एक खाता, एक API कुंजी, और एक सदस्यता + कोटा मॉडल है—न कि प्रति-कॉल—इसलिए आप अलग-अलग प्रदाताओं के लिए अलग क्रेडेंशियल्स को संभाले बिना पुनरावृत्ति कर सकते हैं।
Zyla API Hub पर शुरुआत करना
इस API को तेजी से आज़माने के लिए:
- API सूची खोलें: YouTube सब एक्सट्रैक्टर API पर 7-दिन की परीक्षण अवधि शुरू करें.
- जब उपलब्ध हो, तो सब्सक्राइब या फ्री ट्रायल शुरू करने के लिए क्लिक करें। Zyla पर आपके पहले API के लिए, आपको आमतौर पर 7-दिन की परीक्षण अवधि या 50 अनुरोध मिलते हैं; वर्तमान पहुंच विकल्पों और मूल्य निर्धारण के लिए API पृष्ठ की जांच करें। कोई मुफ्त योजना नहीं है।
- डैशबोर्ड से अपनी API कुंजी कॉपी करें।
- Authorization: Bearer YOUR_API_KEY के साथ नीचे दिखाए गए एंडपॉइंट को कॉल करें।
एंडपॉइंट अवलोकन
YouTube सब एक्सट्रैक्टर API वर्तमान में एकल, केंद्रित एंडपॉइंट को ट्रांसक्रिप्ट प्राप्त करने के लिए उजागर करता है:
- एंडपॉइंट: वीडियो ट्रांसक्रिप्ट प्राप्त करें
- विधि: GET
- URL: https://zylalabs.com/api/5216/youtube-sub-extractor-api/6681/get-video-transcript
- आवश्यक पैरामीटर: videoId (string)
आप जिस YouTube वीडियो को ट्रांसक्राइब करना चाहते हैं उसका videoId भेजें। API एक JSON पेलोड के साथ प्रतिक्रिया करता है जिसमें एक सफलता ध्वज और कैप्शन प्रविष्टियों का ट्रांसक्रिप्ट एरे शामिल होता है। प्रत्येक प्रविष्टि में टेक्स्ट और समय फ़ील्ड होते हैं जिनका आप अपने ऐप में उपयोग कर सकते हैं।
क्विकस्टार्ट: cURL जिसे आप पेस्ट कर सकते हैं
नीचे एक पूरा, कार्यशील अनुरोध है। YOUR_API_KEY को अपनी कुंजी से बदलें। videoId पैरामीटर आवश्यक है, और उदाहरण एक विशिष्ट ID का उपयोग करता है ताकि प्रतिक्रिया के आकार को प्रदर्शित किया जा सके।
curl -s -X GET "https://zylalabs.com/api/5216/youtube-sub-extractor-api/6681/get-video-transcript?videoId=eCBABjPcNyo"
-H "Authorization: Bearer YOUR_API_KEY"
आधिकारिक उदाहरण प्रतिक्रिया
यह API द्वारा ऊपर दिए गए अनुरोध के लिए लौटाई गई वास्तविक उदाहरण JSON है। इसका उपयोग अपने पार्सिंग लॉजिक को संरचित करने के लिए करें।
{"success":true,"transcript":[{"text":"o que a gente tem no diante","duration":3.24,"offset":0,"lang":"en"},{"text":"dos nossos olhos não dá muita esperança","duration":3.24,"offset":3.24,"lang":"en"},{"text":"no futuro daqui eu vejo a polícia","duration":3.24,"offset":6.48,"lang":"en"},{"text":"atirando a dignidade de pais de família","duration":3.24,"offset":9.72,"lang":"en"},{"text":"daqui eu vejo o estado transformando pessoas","duration":3.24,"offset":12.96,"lang":"en"},{"text":"que poderiam dar bons frutos carregado em","duration":3.24,"offset":16.200000000000003,"lang":"en"},{"text":"pessoas frustradas eu não julgo entendeu monstro","duration":3.24,"offset":19.44,"lang":"en"},{"text":"não precisa ser nenhum expert title superlotado","duration":3.24,"offset":22.68,"lang":"en"},{"text":"estudado formada uma coisa pra saber que","duration":3.24,"offset":25.92,"lang":"en"},{"text":"está tudo errado para saber qual a","duration":3.24,"offset":29.160000000000004,"lang":"en"},{"text":"posição da gente isso tem que acabar","duration":3.24,"offset":32.400000000000006,"lang":"en"},{"text":"com os palestinos abete paz [Música] gino","duration":3.24,"offset":35.64,"lang":"en"},{"text":"problema queria só paz mas não viu","duration":3.24,"offset":38.88,"lang":"en"},{"text":"o veículo agora sem proteção da vida","duration":3.24,"offset":42.120000000000005,"lang":"en"},{"text":"e arrojado mas ainda era o então","duration":3.24,"offset":45.36,"lang":"en"},{"text":"ainda disparava e agora o que eu","duration":3.24,"offset":48.6,"lang":"en"},{"text":"faço me fala na maturidade na sala","duration":3.24,"offset":51.84,"lang":"en"},{"text":"tem pesadelo é época de eleição nosso","duration":3.24,"offset":55.080000000000005,"lang":"en"},{"text":"descabelo progresso sem previsão no chão torço","duration":3.24,"offset":58.32000000000001,"lang":"en"},{"text":"pro meu filho também não vira lata","duration":3.24,"offset":61.56,"lang":"en"},{"text":"é um opção tem vaca tem sempre","duration":3.24,"offset":64.80000000000001,"lang":"en"},{"text":"cid piada pode justificar nada eu entrei","duration":3.24,"offset":68.04,"lang":"en"},{"text":"político claro que foi pra vencer nelson","duration":3.24,"offset":71.28,"lang":"en"},{"text":"é um nojo esgoto exposto é alguém","duration":3.24,"offset":74.52000000000001,"lang":"en"},{"text":"é tanta injustiça em sangue nas suas","duration":3.24,"offset":77.76,"lang":"en"},{"text":"mãos por não fazer nada a troca","duration":3.24,"offset":81…
आप जिन प्रमुख फ़ील्ड का उपयोग करेंगे:
- success: यह दर्शाता है कि अनुरोध सफल हुआ या नहीं।
- transcript: कैप्शन आइटम का एरे। प्रत्येक आइटम में शामिल हैं:
- text: उस खंड के लिए कैप्शन टेक्स्ट।
- duration: खंड की संख्यात्मक लंबाई।
- offset: वीडियो की शुरुआत से संख्यात्मक प्रारंभ स्थिति।
- lang: उस खंड से संबंधित एक भाषा कोड।
Python उदाहरण: एक साधारण ट्रांसक्रिप्ट प्राप्त करें और जोड़ें
यह स्निपेट उसी एंडपॉइंट को कॉल करता है और कैप्शन लाइनों को एकल स्ट्रिंग में जोड़ता है जबकि बाद में उपयोग के लिए समय को संरक्षित करता है। यह आपकी API कुंजी के साथ Authorization हेडर का उपयोग करता है और cURL उदाहरण के समान videoId का उपयोग करता है ताकि आप आउटपुट की तुलना कर सकें।
import os
import requests
API_KEY = os.getenv("ZYLA_API_KEY", "YOUR_API_KEY")
VIDEO_ID = "eCBABjPcNyo"
URL = "https://zylalabs.com/api/5216/youtube-sub-extractor-api/6681/get-video-transcript"
resp = requests.get(
URL,
params={"videoId": VIDEO_ID},
headers={"Authorization": f"Bearer {API_KEY}"},
timeout=30
)
resp.raise_for_status()
data = resp.json()
if not data.get("success"):
raise RuntimeError("Transcript request did not succeed")
entries = data.get("transcript", [])
# Keep a simple text transcript and an index of time anchors
full_text = " ".join([e.get("text", "") for e in entries if isinstance(e, dict)])
time_index = [{"offset": e.get("offset"), "duration": e.get("duration"), "text": e.get("text")} for e in entries]
print("First 200 chars of transcript:")
print(full_text[:200])
print("\nFirst 3 time anchors:")
for anchor in time_index[:3]:
print(anchor)
समय बचाने वाले कार्यान्वयन विवरण
- प्रमाणीकरण: हर अनुरोध पर अपनी कुंजी को Authorization: Bearer YOUR_API_KEY के माध्यम से पास करें।
- कैशिंग: एक दिए गए videoId के लिए ट्रांसक्रिप्ट आपके स्तर पर कैशिंग के लिए अच्छे उम्मीदवार होते हैं ताकि गर्म पृष्ठों या बैच कार्यों पर पुनरावृत्त कॉल से बचा जा सके।
- पैजिनेशन: उदाहरण प्रतिक्रिया एक पेलोड में पूर्ण ट्रांसक्रिप्ट एरे लौटाती है। इस एंडपॉइंट के लिए कोई पैजिनेशन पैरामीटर आवश्यक नहीं हैं।
- समय गणित: अवधि और ऑफसेट संख्यात्मक मान हैं। यदि आप कैप्शन को रेंडर करने या जंप लिंक की गणना करने की योजना बना रहे हैं तो उन्हें जैसे हैं वैसे ही संरक्षित करें।
- भाषा: प्रत्येक खंड के लिए एक lang कोड शामिल है। अनुवाद या TTS पाइपलाइनों के लिए रूट करते समय इसका उपयोग करें।
- त्रुटि हैंडलिंग: ट्रांसक्रिप्ट डेटा का उपयोग करने से पहले सफलता ध्वज की जांच करें।
ट्रांसक्रिप्ट के शीर्ष पर वास्तविक सुविधाएँ बनाना
SRT या WebVTT बनाएं
प्रत्येक ट्रांसक्रिप्ट आइटम को कैप्शन ब्लॉक में परिवर्तित करें, ऑफसेट और ऑफसेट+अवधि को समय कोड में प्रारूपित करके। चाहे आप SRT या VTT आउटपुट करें, प्रविष्टियों के मूल क्रम को बनाए रखें। चूंकि API पहले से ही ट्रांसक्रिप्ट को विभाजित करता है, आपको केवल प्रारूपण लॉजिक की आवश्यकता है।
समय एंकर के साथ खोजें
अपने ऑफसेट के साथ टेक्स्ट खंडों को अनुक्रमित करें। जब कोई उपयोगकर्ता खोजता है, तो ऑफसेट के आधार पर "Jump to 01:23" लिंक के साथ मेल खाने वाली पंक्तियाँ दिखाएँ। यह पूरे टेक्स्ट ब्लॉब की खोज की तुलना में घर्षण को कम करता है।
संक्षेपण या हाइलाइट्स निकालें
लक्ष्य आकार (जैसे, वर्णों की संख्या या कुल अवधि) के टुकड़ों में निकटवर्ती प्रविष्टियों को समूहित करें। उन टुकड़ों को अपने संक्षेपणकर्ता में फीड करें और प्रत्येक टुकड़े के प्रारंभिक ऑफसेट के लिंक संलग्न करें।
सामग्री सुरक्षा स्क्रीनिंग
यदि आप सुरक्षा या अनुपालन जांच चलाते हैं, तो पहले उन्हें व्यक्तिगत खंडों पर करें। इससे समस्याग्रस्त स्पैन को ढूंढना और रेडेक्ट करना आसान हो जाता है, क्योंकि आपके पास पहले से ही ऑफसेट और अवधि होती है।
AI एजेंट (MCP) से API कॉल करना
हर Zyla API को AI कोडिंग टूल से बुलाया जा सकता है जो मॉडल संदर्भ प्रोटोकॉल का समर्थन करता है। अपने MCP-संगत क्लाइंट को इस एंडपॉइंट पर इंगित करें: MCP.
- अपने Zyla API कुंजी को MCP क्लाइंट कॉन्फ़िगरेशन के माध्यम से प्रदान करें (एंडपॉइंट उस URL में apikey स्वीकार करता है जिसे आप उपकरण होस्ट के लिए कॉन्फ़िगर करते हैं)।
- Claude Code, Cursor, या Windsurf जैसे एजेंटों से, आप एक उपकरण को वायर कर सकते हैं जो इस पोस्ट में उपयोग किए गए समान GET URL को videoId पैरामीटर के साथ हिट करता है।
- एजेंट JSON पेलोड प्राप्त करता है और ट्रांसक्रिप्ट को पोस्ट-प्रोसेस कर सकता है—जैसे, संक्षेपण, नोट्स उत्पन्न करना, या कोड टिप्पणियों में समय-लिंक किए गए संदर्भ डालना।
यदि आप Zyla के MCP उपकरणों में नए हैं, तो एक सरल उपकरण परिभाषा के साथ शुरू करें जो यहां दिखाए गए एकल एंडपॉइंट को लपेटता है और एजेंट के लिए आगे की तर्क के लिए ट्रांसक्रिप्ट एरे लौटाता है।
Zyla उपयोग पर परिचालन नोट्स
- एक्सेस मॉडल: सदस्यता + कोटा, प्रति-कॉल नहीं। Zyla पर आपके पहले API के लिए, आपको आमतौर पर 7-दिन की परीक्षण अवधि या 50 अनुरोध मिलते हैं। हमेशा वर्तमान सीमाओं और बिलिंग के लिए सूची की जांच करें।
- एक कुंजी, कई सेवाएँ: आपकी Zyla कुंजी सब्सक्राइब की गई APIs में काम करती है, जो CI/CD और सीक्रेट्स प्रबंधन को सरल बनाती है।
- टीम वर्कफ़्लो: अपने सीक्रेट्स मैनेजर में Authorization हेडर को स्टोर करें और इसे अपने रेपो या डिप्लॉयमेंट प्लेटफ़ॉर्म में पर्यावरण चर के माध्यम से साझा करें।
यदि आपके पास अभी तक खाता नहीं है, तो आप Zyla API Hub पर कुछ ही मिनटों में एक बना सकते हैं और सूची पृष्ठ पर सब्सक्राइब करने के तुरंत बाद APIs को कॉल करना शुरू कर सकते हैं।
समस्या निवारण चेकलिस्ट
- 401/403 त्रुटियाँ: पुष्टि करें कि Authorization हेडर Bearer YOUR_API_KEY पर सेट है, और कुंजी आपकी सदस्यता के लिए मान्य है।
- खाली ट्रांसक्रिप्ट: videoId स्ट्रिंग को दोबारा जांचें और सुनिश्चित करें कि वीडियो में उपलब्ध उपशीर्षक डेटा है।
- अप्रत्याशित भाषा कोड: प्रत्येक खंड के लिए lang फ़ील्ड को लॉग करें और यदि आवश्यक हो तो अपने अनुवाद स्टैक के माध्यम से रूट करें।
- आपके क्लाइंट में टाइमआउट: एक उचित टाइमआउट सेट करें (जैसे, 30s) और एक बार पुनः प्रयास करें। videoId द्वारा सफल प्रतिक्रियाओं को कैश करें।
संदर्भ: एंडपॉइंट और पैरामीटर
वीडियो ट्रांसक्रिप्ट प्राप्त करें
- विधि: GET
- URL: https://zylalabs.com/api/5216/youtube-sub-extractor-api/6681/get-video-transcript
- आवश्यक क्वेरी पैरामीटर:
- videoId: YouTube वीडियो ID स्ट्रिंग (जैसे, eCBABjPcNyo)
- प्रमाणीकरण: Authorization: Bearer YOUR_API_KEY
अक्सर पूछे जाने वाले प्रश्न
मुझे अनुरोधों को प्रमाणित करने के लिए क्या चाहिए?
अनुरोध हेडर में Authorization: Bearer YOUR_API_KEY शामिल करें। आप कुंजी को API की सूची पृष्ठ पर सब्सक्राइब करने के बाद प्राप्त करते हैं।
कौन से पैरामीटर आवश्यक हैं?
Get Video Transcript एंडपॉइंट के लिए केवल videoId आवश्यक है।
क्या API समय की जानकारी लौटाता है?
हाँ, प्रत्येक ट्रांसक्रिप्ट आइटम में संख्यात्मक अवधि और ऑफसेट फ़ील्ड शामिल होते हैं जिनका आप कैप्शन समय और जंप लिंक के लिए उपयोग कर सकते हैं।
क्या कोई मुफ्त योजना है?
कोई मुफ्त योजना नहीं है। Zyla पर आपके पहले API के लिए, आपको आमतौर पर 7-दिन की परीक्षण अवधि या 50 अनुरोध मिलते हैं। वर्तमान पहुंच और सीमाओं के लिए API पृष्ठ की जांच करें।
क्या मैं इसे AI एजेंट से कॉल कर सकता हूँ?
हाँ। MCP एंडपॉइंट का उपयोग करें और अपने उपकरण को videoId पैरामीटर के साथ समान GET URL को हिट करने के लिए कॉन्फ़िगर करें। विवरण के लिए ऊपर दिए गए MCP लिंक को देखें।
क्या आप अपनी ट्रांसक्रिप्ट एकीकरण को शिप करने के लिए तैयार हैं? सूची पृष्ठ पर सब्सक्राइब करें और अभी अपनी कुंजी प्राप्त करें: YouTube सब एक्सट्रैक्टर API पर 7-दिन की परीक्षण अवधि शुरू करें.