Відео може мати англійські автоматичні підписи, завантажувачі іспанської доріжки, як і ні. Покупка для мови не створює треку, що відео не має. Цей посібник робить вибір підписів, явним і показує, як зберегти вибрану трек без мовних джерел або джерела підпису.
Автоматичні підписи та завантажувачі
FlashData виводить два зручні джерела: youtube_transcript За замовчуванням для автоматичних підписок, в той час як youtube_captions За замовчуванням для завантажувачів. І підтримка явного params.auto значення: true вибирає автоматичні підписи та false вибирає завантажувальні заглушки. Як отримати наявні підписки YouTube і повернути часові сегменти.
Комплекти params.language до треку потрібно, наприклад en, es або en-US. Обласний код і мовно-нав'язливий код не взаємозамінні обіцянки. Якщо ви запитаєте мову та джерело підпису не є доступним, запит не може бути або не несете ніякого використання тексту. API не автоматично перекладається, генерує мовно-текстовий, або знизиться між джерелами треку.
Виберіть один трек перед відправкою запиту
Використовуйте Node.js 22 або пізніше і API ключ з наявними кредитами. Налаштуйте відео ID, які ви можете обробляти. Для базового текстового експортного процесу див. Отримати субтитри YouTube з JavaScript.
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 і мови при розщепленні трансу на пошук шматків. За допомогою чителю можна перевірити оригінальний контекст. Уникайте лікування сегмента підписки, як новий транскрипція, що виробляється.
Автоматичні підписи можуть містити помилки розпізнавання. Якщо ви використовуєте текст для підсумків або цитат, ви можете перевірити оригінальний сегмент і відео. Наявність і точність є окремими питаннями: успішно перерозподіляє трек не гарантує, що його слово є правильним.
Порівняти транскрипція API і Заклепочники API, або вивчити YouTube Data Аудиторія.