Een video kan Engelse automatische bijschriften, een uploader-aangeleverd Spaanse track, beide, of geen van beide. Vragen naar een taal maakt geen track aan die de video niet heeft. Deze handleiding maakt de bijschriftkeuze expliciet en laat zien hoe je de geselecteerde track kunt opslaan zonder een andere taal of bijschriftbron in stilte te vervangen.
Automatische bijschriften en uploaderonderschriften
FlashData stelt twee handige bronnen bloot: youtube_transcript standaardinstellingen voor automatische bijschriften, terwijl youtube_captions standaardinstellingen voor het uploaden van bijschriften. Beiden steunen een expliciete params.auto waarde: true selecteert automatische bijschriften en false selecteert uploader-onderschriften. Beiden halen bestaande YouTube ondertitels op en retourneren tijd gestempelde segmenten.
Instellen params.language naar de track die je nodig hebt, bijvoorbeeld en, es of en-US. Een regionale code en een taal-alleen-code zijn geen verwisselbare beloften. Als de gewenste taal- en bijschriftbron niet beschikbaar is, kan het verzoek mislukken of geen bruikbare tekst bevatten. De API vertaalt, genereert spraak-naar-tekst niet automatisch of valt niet terug tussen trackbronnen.
Kies één track voordat u het verzoek verstuurt
Gebruik Node.js 22 of hoger en een API-sleutel met beschikbare Credits. Stel een video in ID die u mag verwerken. Voor de basistekst export workflow, zie YouTube-ondertitels met JavaScript.
export FLASHDATA_API_KEY='your-api-key'
export YOUTUBE_VIDEO_ID='your-video-id'
export CAPTION_LANGUAGE='en'
export CAPTION_AUTO='true'
Gebruik CAPTION_AUTO=false om een track met uploader te vragen. Het script stuurt precies één verzoek. Het probeert niet elke taal of geeft een tweede betaalde verzoek automatisch wanneer de eerste mislukt.
De gekozen track ophalen en tijdstempels behouden
Sla de volgende code op als caption-track.mjs. Het valideert de invoerkeuze, controleert op tool-level fouten en HTTP storingen, en bewaart de taal en bron informatie die in de reactie.
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
Wat te doen wanneer de gevraagde track ontbreekt?
Controleer de fout voordat u de bijschriftinstellingen wijzigt. Een ongeldige sleutel, onvoldoende Credits of een timeout is geen bewijs dat de video geen bijschriften bevat.
Als u al videometadata ophaalt, inspecteer dan
hasTranscriptsentranscriptLanguagesals nuttige signalen. Een gerapporteerde taal garandeert niet dat zowel automatische als uploader-aangeleverde tracks in die taal bestaan.Als een alternatieve track aanvaardbaar is voor uw use case, kies dan bewust en doe een apart verzoek. Registreer de gevraagde en geretourneerde taal en
isAutoGeneratedwaarde met de tekst.Als uw workflow de exacte track vereist, markeer het item niet beschikbaar en ga verder met andere video's. Herhaaldelijk hetzelfde verzoek versturen zal geen ontbrekende bijschriften aanmaken.
Houd taal en tijdstempel herkomst met uw tekst
Segmenten bevatten start, end en text; tijden worden gemeten in seconden. Houd de video ID en taal bij het splitsen van een transcript in zoekblokken. Een videolink met een tijdstempel kan een lezer helpen de oorspronkelijke context te verifiëren. Vermijd het behandelen van een bijschrift segment als een nieuwe transcriptie die uw toepassing geproduceerd.
Automatische bijschriften kunnen herkenningsfouten bevatten. Als u de tekst gebruikt voor samenvattingen of citaten, geef dan een manier om het oorspronkelijke segment en video te inspecteren. Beschikbaarheid en nauwkeurigheid zijn afzonderlijke vragen: succesvol een track ophalen garandeert niet dat de formulering juist is.
Vergelijk de Transcript API en Bijschriften API, of de YouTube Data API's.