Một đoạn video có thể có tiêu đề tiếng Anh, một đoạn phim được đăng tải tiếng Tây Ban Nha, cả hai hoặc cả hai. Yêu cầu một ngôn ngữ không tạo ra một đường nét mà video không có. Hướng dẫn này giúp cho lựa chọn đầu đề rõ ràng và hiển thị cách lưu đường dẫn đã chọn mà không âm thầm thay thế một ngôn ngữ hay một nguồn chú thích khác.
Đầu đề tự động và chú thích tải lên
FlashData phơi bày hai nguồn tiện lợi: youtube_transcript mặc định là phụ đề tự động, còn youtube_captions mặc định là tên người tải lên. Cả hai đều ủng hộ một cách rõ ràng params.auto giá trị: true chọn đầu đề tự động và false chọn những phụ đề tải lên. Cả hai đều đã có sẵn YouTube đánh dấu các đoạn văn đã đánh dấu thời gian và đánh dấu thời gian.
Đặt params.language ví dụ, để theo dõi bạn cần en, es hay en-US. Một mã vùng và một mật mã chỉ có ngôn ngữ không phải là lời hứa trao đổi được. Nếu không có ngôn ngữ và tài liệu tiêu đề đã yêu cầu, yêu cầu có thể thất bại hoặc không có văn bản có khả năng sử dụng. Hạt API không tự động dịch, tạo tiếng nói để văn bản, hoặc rơi lại giữa các nguồn theo dõi.
Chọn một đường dẫn trước khi gửi yêu cầu
Dùng Node.js 22 hoặc sau này và một Phím API với các nguồn tín dụng sẵn có. Đặt một video ID Anh được phép xử lý. Cho việc xuất bản văn bản cơ bản, thấy chưa Được YouTube Phụ đề JavaScript.
export FLASHDATA_API_KEY='your-api-key'
export YOUTUBE_VIDEO_ID='your-video-id'
export CAPTION_LANGUAGE='en'
export CAPTION_AUTO='true'
Dùng CAPTION_AUTO=false để yêu cầu một đường ray tải lên được xác nhận. Kịch bản gửi chính xác một yêu cầu. Nó không thử mọi ngôn ngữ hoặc ra yêu cầu trả lương thứ hai khi ngôn ngữ đầu tiên thất bại.
Lấy các dấu vết đã chọn và giữ nhãn thời gian
Lưu mã sau như caption-track.mjs. Nó xác nhận lựa chọn nhập, kiểm tra các lỗi cấp công cụ cũng như HTTP Thất bại, và bảo tồn thông tin ngôn ngữ và nguồn tin được báo cáo.
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
Phải làm gì khi đường ray đã yêu cầu bị mất
Kiểm tra lỗi trước khi thay đổi thiết lập phụ đề. Một khóa không hợp lệ, không đủ nguồn tư liệu hoặc thời hạn không phải là bằng chứng cho thấy video thiếu phụ đề.
Nếu bạn đã có được video siêu dữ liệu, thanh tra
hasTranscriptsvàtranscriptLanguageslà những tín hiệu hữu ích. Một ngôn ngữ đã được báo cáo không bảo đảm rằng các dấu vết tự động và tải lên đều tồn tại trong ngôn ngữ đó.Nếu trường hợp bạn dùng trường hợp của bạn chấp nhận một đường lối khác, hãy cố tình chọn và yêu cầu riêng. Ghi lại ngôn ngữ đã yêu cầu và trở về và
isAutoGeneratedgiá trị với văn bản.Nếu dòng làm việc của bạn yêu cầu kiểu chính xác, hãy đánh dấu mục này không sẵn sàng và tiếp tục với các video khác. Thường xuyên gửi cùng một yêu cầu sẽ không tạo ra chú thích bị mất.
Giữ nhãn thời gian và ngôn ngữ trong văn bản
Đoạn start, end và text; thời gian được đo bằng giây. Giữ đoạn phim ID và ngôn ngữ khi chia bản ghi thành các đoạn tìm kiếm. Liên kết video có nhãn thời gian có thể giúp độc giả xác minh bối cảnh ban đầu. Tránh xem phần phụ đề là bản sao mới do ứng dụng tạo ra.
Các phụ đề tự động có thể chứa lỗi nhận diện. Nếu dùng đoạn để tóm tắt hoặc trích dẫn, hãy cung cấp cách để kiểm tra đoạn đầu tiên và đoạn video. Tính dễ bị tổn thương và tính chính xác là những câu hỏi riêng biệt: Thành công trong việc lấy một đường đua không bảo đảm rằng từ ngữ của nó là đúng.
So sánh Transcript API và Độ xoay: API, hoặc khám phá YouTube Data APIs.