API से YouTube ट्रांसक्रिप्ट कैसे पाएँ (curl, Python, JavaScript)

API से YouTube ट्रांसक्रिप्ट पाने के लिए वीडियो के URL या ID और एक API कुंजी के साथ एक HTTP अनुरोध भेजें, और जवाब से ट्रांसक्रिप्ट पढ़ें। यह गाइड sum.video Transcript API के साथ curl, Python और JavaScript में अनुरोध दिखाती है, फिर फ़ॉर्मेट, एरर और लागत की बात करती है।

API क्या लौटाती है

यह एंडपॉइंट किसी सार्वजनिक YouTube वीडियो के मौजूदा कैप्शन लौटाता है, चाहे वे निर्माता ने लिखे हों या YouTube ने अपने आप बनाए हों। यह ऑडियो को टेक्स्ट में नहीं बदलता। अगर वीडियो में कैप्शन नहीं हैं, तो अंदाज़े के बजाय आपको एरर मिलता है (इस पर नीचे और)।

बुनियादी बातें:

• एंडपॉइंट: POST https://sum.video/api/v1/transcript (GET भी चलता है)
• प्रमाणीकरण: आपकी कुंजी X-API-Key हेडर में, या Authorization: Bearer <key>
• इनपुट: url या video_id
• वैकल्पिक lang (डिफ़ॉल्ट en)
• वैकल्पिक format: json, text या srt

जवाब में कैप्शन ट्रैक की असली भाषा और यह भी बताया जाता है कि वह अपने आप बना है या नहीं, ताकि आपको पता रहे कि कैसी गुणवत्ता की उम्मीद करें।

चरण 1: API कुंजी बनाएँ

साइन इन करें और API डैशबोर्ड (sum.video पर /dashboard/api) में एक कुंजी बनाएँ। आप अधिकतम 5 सक्रिय कुंजियाँ रख सकते हैं, जो स्टेजिंग और प्रोडक्शन कुंजी अलग रखने में काम आती हैं। आपकी पहली कुंजी के साथ 10 मुफ़्त क्रेडिट आते हैं, जो 5 ट्रांसक्रिप्ट के लिए काफ़ी हैं, इसलिए नीचे की हर चीज़ आप बिना लागत के आज़मा सकते हैं।

चरण 2: पहला अनुरोध भेजें

curl

curl -X POST https://sum.video/api/v1/transcript \
  -H "X-API-Key: $SUMVIDEO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ", "lang": "en", "format": "text"}'

क्योंकि GET भी चलता है, आप ऐसी स्क्रिप्ट से भी जाँच कर सकते हैं जो सिर्फ़ URL बनाती है। कुंजी को हेडर में देना बेहतर है, ताकि वह लॉग में न पहुँचे।

Python

import os
import requests

resp = requests.post(
    "https://sum.video/api/v1/transcript",
    headers={"X-API-Key": os.environ["SUMVIDEO_API_KEY"]},
    json={"video_id": "dQw4w9WgXcQ", "lang": "en", "format": "text"},
    timeout=30,
)

if resp.status_code == 404:
    print("No captions for this video")
else:
    resp.raise_for_status()
    print(resp.text)

JavaScript (Node 18+ या ब्राउज़र)

const resp = await fetch("https://sum.video/api/v1/transcript", {
  method: "POST",
  headers: {
    "X-API-Key": process.env.SUMVIDEO_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    video_id: "dQw4w9WgXcQ",
    lang: "en",
    format: "text",
  }),
});

if (resp.status === 404) {
  console.log("No captions for this video");
} else if (!resp.ok) {
  throw new Error(`Request failed: ${resp.status}`);
} else {
  console.log(await resp.text());
}

कुंजी को सर्वर पर रखें। ब्राउज़र कोड में रखी कुंजी को डेवलपर टूल खोलने वाला कोई भी कॉपी कर सकता है।

चरण 3: सही फ़ॉर्मेट चुनें

अगर आप वीडियो के किसी पल से लिंक करना चाहते हैं, तो json इस्तेमाल करें और सेगमेंट के offset से लिंक बनाएँ। LLM को देने के लिए text छोटा और सरल है। अगर आप बाद में ट्रांसक्रिप्ट के अंदर हाथ से खोजना चाहें, तो YouTube वीडियो के ट्रांसक्रिप्ट के अंदर कैसे खोजें देखें।

चरण 4: भाषा चुनें

lang का डिफ़ॉल्ट en है। इसे अपनी पसंद की भाषा पर सेट करें, जैसे de या es। जवाब में उस ट्रैक की भाषा बताई जाती है जो असल में लौटा, इसलिए अनुमान लगाने के बजाय उसे जाँचें। किसी वीडियो में अक्सर सिर्फ़ एक कैप्शन ट्रैक होता है, और API असली कैप्शन लौटाती है, इसलिए वह आपके लिए अनुवाद नहीं करती।

चरण 5: एरर संभालें

पहले दिन से इन मामलों की योजना बनाएँ:

• 404 no_transcript: वीडियो में कैप्शन नहीं हैं, या वह लाइव स्ट्रीम, निजी वीडियो या हटाया गया वीडियो है। दोबारा कोशिश करने को कुछ नहीं है। इसे छोड़ दें, या उपयोगकर्ता से दूसरा वीडियो माँगें।
• 402 budget_exceeded: आप अपनी तय की हुई मासिक क्रेडिट सीमा तक पहुँच गए हैं। अगला खंड देखें।
• दर सीमा: हर कुंजी प्रति मिनट 60 अनुरोध की अनुमति देती है। बैच काम को अंतराल देकर चलाएँ, और रोके जाने पर धीमे हो जाएँ।
• हमारी तरफ़ की विफलताएँ: थोड़ी देर बाद फिर कोशिश करें। इनकी कोई लागत नहीं है।

सर्वर एरर पर दोबारा कोशिश करने और 404 पर छोड़ देने वाला एक सरल लूप प्रोडक्शन की ज़्यादातर ज़रूरतें पूरी कर देता है।

लागत कितनी है

हर ट्रांसक्रिप्ट की लागत 2 क्रेडिट है। जो अनुरोध ट्रांसक्रिप्ट नहीं लौटाते या sum.video की तरफ़ से विफल होते हैं, उनकी कोई लागत नहीं है, इसलिए 404 आपका बैलेंस कभी नहीं घटाता। बैलेंस आप GET /api/v1/credits से देख सकते हैं।

क्रेडिट एक बार के पैक में बिकते हैं जो कभी समाप्त नहीं होते:

Pro सब्सक्राइबरों को हर महीने 100 बोनस क्रेडिट भी मिलते हैं। भारी काम के लिए, जैसे पूरा चैनल लोड करना, परिदृश्य बड़े पैमाने पर RAG ऐप के लिए YouTube ट्रांसक्रिप्ट पढ़ें, जो ऑटो टॉप-अप और बजट को कवर करता है। कीमतें भी देखें।

बनाने से पहले जानने लायक सीमाएँ

• सिर्फ़ कैप्शन वाले वीडियो काम करते हैं। 404 no_transcript की यही मुख्य वजह है।
• अपने आप बने कैप्शन में ग़लतियाँ हो सकती हैं, ख़ासकर नामों, लहजों और तकनीकी शब्दों में।
• API सिर्फ़ ट्रांसक्रिप्ट लौटाती है। वह सारांश नहीं बनाती। अगर आप ट्रांसक्रिप्ट के ऊपर सारांश, टाइमस्टैंप और चैट चाहते हैं, तो वह YouTube सारांशकर्ता करता है, और ट्रांसक्रिप्ट टूल एक वीडियो के लिए बिना कोड वाला संस्करण है।
• आधिकारिक YouTube Data API यहाँ विकल्प नहीं है। उसकी कैप्शन डाउनलोड विधि के लिए वीडियो संपादित करने की अनुमति चाहिए, इसलिए वह आपके अपने वीडियो के लिए है (Google दस्तावेज़)।

स्रोत

• YouTube Data API: Captions.download
• sum.video Transcript API