एक वीडियो में अंग्रेजी स्वचालित कैप्शन, एक अपलोडर-निर्मित स्पेनिश ट्रैक, दोनों या न तो हो सकता है। किसी भाषा के लिए पूछते हुए एक ट्रैक नहीं बनाती है कि वीडियो में नहीं है। यह गाइड कैप्शन विकल्प को स्पष्ट करता है और दिखाता है कि चयनित ट्रैक को चुपचाप किसी अन्य भाषा या कैप्शन स्रोत को प्रतिस्थापन के बिना कैसे बचाया जाए।
स्वचालित कैप्शन और अपलोडर-निर्मित कैप्शन
FlashData दो सुविधाजनक स्रोतों को उजागर करता है: youtube_transcript स्वचालित कैप्शन के लिए डिफ़ॉल्ट, जबकि youtube_captions अपलोडर प्रदान किए गए कैप्शन के लिए डिफ़ॉल्ट। दोनों एक स्पष्ट समर्थन करते हैं params.auto मान: true स्वचालित कैप्शन चुनिए और false अपलोडर प्रदान किए गए कैप्शन का चयन करता है। दोनों मौजूदा YouTube कैप्शन को पुनः प्राप्त करते हैं और टाइमटाम्प्ड सेगमेंट वापस करते हैं।
सेट params.language उदाहरण के लिए, आपको जिस ट्रैक की आवश्यकता है, उसके लिए en, es या en-US. एक क्षेत्रीय कोड और एक भाषा-केवल कोड विनिमेय वादे नहीं हैं। यदि अनुरोधित भाषा और कैप्शन स्रोत अनुपलब्ध हैं, तो अनुरोध विफल हो सकता है या कोई उपयोग योग्य पाठ नहीं है। API स्वचालित रूप से अनुवाद नहीं करता है, भाषण-टू-टेक्स्ट उत्पन्न करता है, या ट्रैक स्रोतों के बीच वापस गिरता है।
अनुरोध भेजने से पहले एक ट्रैक चुनें
Node.js 22 या बाद में और एक का उपयोग करें API कुंजी उपलब्ध क्रेडिट के साथ। एक वीडियो सेट करें ID जिसे आप संसाधित करने की अनुमति देते हैं। मूल पाठ निर्यात वर्कफ़्लो के लिए, देखें JavaScript के साथ YouTube उपशीर्षक प्राप्त करें.
export FLASHDATA_API_KEY='your-api-key'
export YOUTUBE_VIDEO_ID='your-video-id'
export CAPTION_LANGUAGE='en'
export CAPTION_AUTO='true'
उपयोग CAPTION_AUTO=false एक अपलोडर प्रदान ट्रैक के लिए पूछने के लिए। स्क्रिप्ट वास्तव में एक अनुरोध भेजता है। यह प्रत्येक भाषा की कोशिश नहीं करता है या पहले विफल होने पर स्वचालित रूप से दूसरे भुगतान अनुरोध को जारी करता है।
चुने गए ट्रैक को आकर्षित करें और टाइमस्टैम्प रखें
निम्नलिखित कोड को सहेजें caption-track.mjs. यह इनपुट विकल्प को मान्य करता है, टूल-लेवल त्रुटियों के साथ-साथ HTTP विफलताओं की जांच करता है, और प्रतिक्रिया में रिपोर्ट की गई भाषा और स्रोत जानकारी को संरक्षित करता है।
import { writeFile } from "node:fs/promises";
const key = process.env.FLASHDATA_API_KEY;
const videoId = process.env.YOUTUBE_VIDEO_ID;
const language = process.env.CAPTION_LANGUAGE ?? "en";
const autoSetting = process.env.CAPTION_AUTO ?? "true";
if (!key || !/^[A-Za-z0-9_-]{11}$/.test(videoId ?? "")) {
throw new Error("Set FLASHDATA_API_KEY and an 11-character YOUTUBE_VIDEO_ID.");
}
if (!["true", "false"].includes(autoSetting)) {
throw new Error("CAPTION_AUTO must be true or false.");
}
if (!/^[A-Za-z0-9-]{1,35}$/.test(language)) {
throw new Error("Use a caption language code such as en or en-US.");
}
const auto = autoSetting === "true";
const source = auto ? "youtube_transcript" : "youtube_captions";
const response = await fetch("https://data.flashdata.dev/v1/queries/realtime", {
method: "POST",
headers: { "Content-Type": "application/json", "X-API-Key": key },
body: JSON.stringify({ source, video_id: videoId, params: { language, auto } }),
signal: AbortSignal.timeout(60000),
});
const payload = await response.json();
if (!response.ok || payload.error || payload.status !== "done") {
console.error(JSON.stringify({ httpStatus: response.status,
requestId: response.headers.get("x-request-id"),
detail: payload.detail ?? payload.message ?? payload.error }, null, 2));
throw new Error("Caption request failed. Inspect the error before trying another track.");
}
const track = payload.results?.[0];
if (!Array.isArray(track?.segments) || !track.segments.some(s => s.text?.trim())) {
throw new Error("No usable caption segments were returned for this selection.");
}
const saved = {
requested: { videoId, language, auto },
returned: { videoId: track.videoId, languageCode: track.languageCode,
isAutoGenerated: track.isAutoGenerated, segments: track.segments },
};
await writeFile("caption-track.json", JSON.stringify(saved, null, 2));
await writeFile("caption-track.txt", track.fullText || track.segments.map(s => s.text).join("\n"));
console.log(`Saved ${track.segments.length} segments from ${track.languageCode}`);
node caption-track.mjs
जब अनुरोध किया गया ट्रैक गायब हो जाता है तो क्या करना चाहिए
कैप्शन सेटिंग बदलने से पहले त्रुटि की जांच करें। एक अमान्य कुंजी, अपर्याप्त क्रेडिट या एक टाइमआउट सबूत नहीं है कि वीडियो में कैप्शन की कमी है।
यदि आप पहले से ही वीडियो मेटाडाटा प्राप्त करते हैं, तो निरीक्षण करें
hasTranscriptsऔरtranscriptLanguagesउपयोगी संकेत के रूप में। एक रिपोर्ट की गई भाषा यह गारंटी नहीं देती है कि उस भाषा में स्वचालित और अपलोडर द्वारा प्रदान किए गए ट्रैक दोनों मौजूद हैं।यदि आपके उपयोग के मामले के लिए वैकल्पिक ट्रैक स्वीकार्य है, तो इसे जानबूझकर चुनें और एक अलग अनुरोध करें। अनुरोधित और वापसी की भाषा रिकॉर्ड करें और
isAutoGeneratedपाठ के साथ मूल्य।यदि आपके वर्कफ़्लो को सटीक ट्रैक की आवश्यकता होती है, तो आइटम को अनुपलब्ध चिह्नित करें और अन्य वीडियो के साथ जारी रखें। बार-बार उसी अनुरोध को भेजने से लापता कैप्शन नहीं बनेंगे।
अपने पाठ के साथ भाषा और टाइमस्टैम्प सिद्धि रखें
खंडों में शामिल हैं start, end और text; समय सेकंड में मापा जाता है। वीडियो ID और भाषा को जब खोज चंकों में एक ट्रांसक्रिप्ट को विभाजित किया जाता है। एक टाइमटाम्प्ड वीडियो लिंक एक रीडर को मूल संदर्भ को सत्यापित करने में मदद कर सकता है। एक नए ट्रांसक्रिप्शन के रूप में एक कैप्शन खंड का इलाज करने से बचें जो आपके आवेदन का उत्पादन करता है।
स्वचालित कैप्शन में मान्यता त्रुटियां हो सकती हैं। यदि आप सारांश या उद्धरण के लिए पाठ का उपयोग करते हैं, तो मूल खंड और वीडियो का निरीक्षण करने का एक तरीका प्रदान करें। उपलब्धता और सटीकता अलग-अलग सवाल हैं: सफलतापूर्वक एक ट्रैक को पुनः प्राप्त करने की गारंटी नहीं देता कि इसका शब्द सही है।
तुलना करें Transcript API और कैप्शन API, या पता लगाना YouTube Data एपीआई.