コンテンツへスキップ
JA
APIキーを取得する

YouTube Data / JavaScript

YouTubeのキャプション:言語を選択し、不足しているトラックを処理する

オートマチックまたはアップローダー機能の選択 YouTube 言語によるキャプション、タイムスタンプを保存し、欠落したトラックを明示的に処理します。 JavaScript.

FlashData · 出版情報

ビデオフレームの下に選択した2つのキャプショントラック

ビデオは、英語の自動キャプション、アップローダーが証明されたスペイン語のトラック、両方、または両方を持つことができます。 言葉を尋ねると、ビデオが持っていないトラックは作成されません。 このガイドは、キャプションの選択を明示し、別の言語またはキャプションソースをサイレントに置換することなく、選択したトラックを保存する方法を示しています。

自動キャプションとアップローダー機能のキャプション

FlashDataは2つの便利な源をexposesします: youtube_transcript 自動キャプションへのデフォルト, 一方 youtube_captions デフォルトでは、uploader-provided のキャプションが使用されます。 両方とも明示的なサポート params.auto 値: true 自動キャプションを選択し、 false アップローダーが付与されたキャプションを選択します。 既存のYouTubeのキャプションとリターンタイムスタンプされたセグメントの両方を取得します。

セットセット params.language 必要なトラックに、例えば en, es または en-US. 地域コードと言語のみのコードは、変更できない約束ではありません。 要求された言語とキャプションソースが利用できなくなった場合、リクエストは失敗するか、または使用可能なテキストがない可能性があります。 API は、自動翻訳、音声テキストの生成、またはトラックソース間のフォールバックしません。

リクエストを送信する前に1つのトラックを選択してください

Node.js 22 またはそれ以上および使用して下さい APIキー 利用可能なクレジットで。 処理する許可されているビデオIDを設定します。 基本的なテキストエクスポートワークフローについては、 詳しくはこちら YouTube 字幕付き JavaScript.

bash
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 アップローダーが付与されたトラックを依頼する。 スクリプトは1つのリクエストを正確に送信します。 最初の1つが失敗したときに、すべての言語を試したり、第二の有料リクエストを自動で発行したりしません。

選択したトラックを取得し、タイムスタンプを保持する

次のコードを以下のように保存します。 caption-track.mjs. 入力選択を検証し、ツールレベルのエラーやHTTPの失敗をチェックし、応答で報告された言語とソース情報を保存します。

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

要求されたトラックが欠落したときに何をすべきか

  • キャプション設定を変更する前にエラーを確認してください。 無効なキー、不十分なクレジットまたはタイムアウトは、ビデオがキャプションを欠いているという証拠ではありません。

  • 既にビデオメタデータを取得している場合は、検査 hasTranscripts とりあえず transcriptLanguages 有用な信号として。 報告された言語は、その言語で自動およびアップロードされたトラックの両方が存在していることを保証するものではありません。

  • 代替トラックがあなたのユースケースのために許容されている場合は、それを意図的に選択し、別々の要求を行います。 要求された言語と返された言語を録音し、 isAutoGenerated テキストで値します。

  • ワークフローが正確なトラックを必要とする場合は、アイテムが利用できなくなったり、他の動画を続行したりします。 同じリクエストを繰り返し送信すると、欠落したキャプションは作成されません。

テキストで言語とタイムスタンプの実績を保ちましょう

セグメントには start, end とりあえず text; は秒単位で測定されます。 トランスクリプトを検索チャンクに分割する際に、ビデオIDと言語を保ちます。 タイムスタンプされたビデオリンクは、読者が元の文脈を検証するのに役立ちます。 アプリケーションが生成した新しいトランスクリプションとしてキャプションセグメントを処理しないようにします。

自動キャプションは、認識エラーを含むことができます。 要約や引用語句のテキストを使用する場合は、元のセグメントとビデオの検査方法を提供します。 可用性と精度は別々の質問です。トラックをうまく取得すると、その言葉が正しいことを保証するものではありません。

比較する トランスクリプト API とりあえず キャプション API, 、または探検して下さい YouTube Data API の使い方.