Überspringen zum Inhalt
DE
API-Schlüssel

YouTube Data / JavaScript

YouTube-Beschriftungen: Wählen Sie eine Sprache und behandeln Sie fehlende Spuren

Wählen Sie automatische oder von Uploadern bereitgestellte YouTube-Beschriftungen nach Sprache, bewahren Sie Zeitstempel auf und behandeln Sie fehlende Spuren explizit mit JavaScript.

FlashData · Veröffentlicht

Zwei Untertitelspuren mit einer ausgewählten unter einem Videorahmen

Ein Video kann englische automatische Beschriftungen, einen von Uploadern bereitgestellten spanischen Track, beide oder keines von beiden haben. Die Frage nach einer Sprache erzeugt keinen Track, den das Video nicht hat. Dieses Handbuch macht die Beschriftungsauswahl explizit und zeigt, wie man den ausgewählten Track speichert, ohne stillschweigend eine andere Sprache oder Beschriftungsquelle zu ersetzen.

Automatische Bildunterschriften und Uploader bereitgestellte Bildunterschriften

FlashData zeigt zwei bequeme Quellen: youtube_transcript Standardmäßig auf automatische Beschriftungen, während youtube_captions standardmäßigen Bildunterschriften von Uploadern. Beide unterstützen eine explizite params.auto Wert: true automatische Beschriftungen auswählt und false wählt von Uploadern bereitgestellte Untertitel aus. Beide rufen vorhandene YouTube-Beschriftungen ab und geben zeitgestempelte Segmente zurück.

Setz params.language zu der Strecke, die Sie benötigen, zum Beispiel en, es oder en-US. Ein Regionalcode und ein Sprachcode sind keine austauschbaren Versprechen. Wenn die angeforderte Sprache und die Beschriftungsquelle nicht verfügbar sind, kann die Anforderung fehlschlagen oder keinen verwendbaren Text enthalten. Der API übersetzt nicht automatisch, generiert Sprache-zu-Text oder greift zwischen Trackquellen zurück.

Wählen Sie einen Track aus, bevor Sie die Anfrage senden

Verwenden Sie Node.js 22 oder höher und ein API Schlüssel mit verfügbaren Credits. Stellen Sie ein Video ID ein, das Sie verarbeiten dürfen. Für den grundlegenden Textexport-Workflow siehe Erhalten Sie YouTube Untertitel mit JavaScript.

bash
export FLASHDATA_API_KEY='your-api-key'
export YOUTUBE_VIDEO_ID='your-video-id'
export CAPTION_LANGUAGE='en'
export CAPTION_AUTO='true'

Verwendung CAPTION_AUTO=false um nach einem von einem uploader bereitgestellten track zu fragen. Das Skript sendet genau eine Anfrage. Es versucht nicht jede Sprache oder gibt automatisch eine zweite bezahlte Anfrage aus, wenn die erste fehlschlägt.

Holen Sie sich den gewählten Track und behalten Sie Zeitstempel

Speichern Sie den folgenden Code als caption-track.mjs. Es validiert die Eingabeauswahl, prüft auf Fehler auf Tool-Ebene sowie auf HTTP-Ausfälle und bewahrt die in der Antwort gemeldeten Sprach- und Quellinformationen.

javascript
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}`);
bash
node caption-track.mjs

Was tun, wenn der angeforderte Track fehlt

  • Überprüfen Sie den Fehler, bevor Sie die Beschriftungseinstellungen ändern. Ein ungültiger Schlüssel, unzureichende Credits oder ein Timeout sind kein Beweis dafür, dass das Video keine Bildunterschriften enthält.

  • Wenn Sie bereits Video-Metadaten abrufen, prüfen Sie hasTranscripts und transcriptLanguages Als nützliche Signale. Eine gemeldete Sprache garantiert nicht, dass sowohl automatische als auch von Uploadern bereitgestellte Tracks in dieser Sprache vorhanden sind.

  • Wenn ein alternativer Track für Ihren Anwendungsfall akzeptabel ist, wählen Sie ihn bewusst aus und stellen Sie eine separate Anfrage. die angeforderte und zurückgegebene Sprache aufzeichnen und isAutoGenerated Wert mit dem Text.

  • Wenn Ihr Workflow den genauen Track erfordert, markieren Sie das Element nicht verfügbar und fahren Sie mit anderen Videos fort. Das wiederholte Senden der gleichen Anfrage erzeugt keine fehlenden Bildunterschriften.

Behalten Sie Sprache und Zeitstempelherkunft mit Ihrem Text

Segmente enthalten start, end und text; Die Zeiten werden in Sekunden gemessen. Behalten Sie das Video ID und die Sprache bei der Aufteilung eines Transkripts in Suchblöcke. Ein zeitgestempelter Videolink kann einem Leser helfen, den ursprünglichen Kontext zu überprüfen. Vermeiden Sie es, ein Beschriftungssegment als neue Transkription zu behandeln, die Ihre Anwendung erstellt hat.

Automatische Beschriftungen können Erkennungsfehler enthalten. Wenn Sie den Text für Zusammenfassungen oder Zitate verwenden, geben Sie eine Möglichkeit an, das Originalsegment und das Originalvideo zu inspizieren. Verfügbarkeit und Genauigkeit sind getrennte Fragen: Das erfolgreiche Abrufen eines Tracks garantiert nicht, dass sein Wortlaut korrekt ist.

Vergleichen Sie die Transkript API und Beschreibung API, oder erkunden Sie die YouTube Data APIs.