Lewati ke isi
ID
Dapatkan kunci API

YouTube Data / JavaScript

YouTube captions: pilih suatu bahasa dan tangani trek yang hilang

Pilih otomatis atau uphader yang disediakan YouTube berdasarkan bahasa, simpan penanda waktu, dan tangani trek yang hilang secara eksplisit dengan JavaScript.

FlashData · Diterbitkan

Dua trek judul dengan satu yang dipilih di bawah suatu bingkai video

Sebuah video dapat memiliki bahasa Inggris otomatis takarir, uphauder - disediakan lagu Spanyol, baik, atau tidak. Meminta bahasa tidak membuat trek yang tidak dimiliki video. Panduan ini membuat pilihan judul eksplisit dan menunjukkan bagaimana menyimpan trek yang dipilih tanpa diam-diam menggantikan bahasa lain atau sumber judul.

Judul otomatis dan uphagder- menyediakan terjemahan

FlashData mengekspos dua sumber yang nyaman: youtube_transcript baku ke takarir otomatis, sementara youtube_captions baku ke uphagder-disediakan takarir. Keduanya mendukung eksplisit params.auto nilai: true memilih terjemahan otomatis dan false memilih uphadder-disediakan takarir. Keduanya mengambil keterangan YouTube yang sudah ada dan mengembalikan segmen yang distempel waktu.

Set params.language ke trek yang Anda butuhkan, misalnya en, es atau en-US. Sebuah kode regional dan lesu - satu-satunya kode yang tidak bisa diubah janji. Bila sumber bahasa dan judul yang diminta tidak tersedia, permintaan dapat gagal atau tidak memiliki teks yang dapat digunakan. API tidak secara otomatis menerjemahkan, menghasilkan speech-to- teks, atau mundur diantara sumber-sumber trek.

Pilih satu trek sebelum mengirim permintaan

Gunakan Node.js 22 atau nanti dan kunci API dengan Credits yang tersedia. Atur video ID Anda diijinkan untuk memproses. Untuk ekspor teks dasar alur kerja, lihat Dapatkan YouTube Subjudul dengan JavaScript.

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

Gunakan CAPTION_AUTO=false untuk meminta uphagder- jalur yang disediakan. Naskah ini mengirimkan tepat satu permintaan. Ini tidak mencoba setiap bahasa atau masalah permintaan dibayar kedua otomatis ketika yang pertama gagal.

Ambil trek yang dipilih dan simpan penanda waktu

Simpan kode berikut sebagai caption-track.mjs. Ini memvalidasi pilihan masukan, memeriksa kesalahan tingkat tool- serta kegagalan HTTP, dan mempertahankan bahasa dan informasi sumber yang dilaporkan dalam respon.

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

Apa yang harus dilakukan ketika trek yang diminta hilang

  • Periksa kesalahan sebelum mengubah pengaturan judul. Kunci tidak valid, Credits tidak cukup atau timeout bukan bukti bahwa video tidak memiliki terjemahan.

  • Jika Anda sudah mengambil metadata video, memeriksa hasTranscripts dan transcriptLanguages sebagai sinyal yang berguna. Sebuah bahasa yang dilaporkan tidak menjamin bahwa baik otomatis dan uphagder-disediakan trek ada dalam bahasa itu.

  • Jika trek alternatif dapat diterima bagi kasus penggunaan Anda, pilih dengan sengaja dan buat permintaan terpisah. Rekam yang diminta dan kembali bahasa dan isAutoGenerated nilai dengan teks.

  • Bila alur kerja Anda memerlukan trek yang tepat, tandai butir yang tak tersedia dan lanjutkan dengan video lain. Berulang kali mengirim permintaan yang sama tidak akan membuat takarir yang hilang.

Jaga bahasa dan provenance timestamp dengan teks Anda

Segmen berisi start, end dan text; waktu diukur dalam detik. Simpan video ID dan bahasa ketika membagi transkrip ke dalam potongan pencarian. Tautan video yang dicap dapat membantu pembaca memverifikasi konteks asli. Hindari memperlakukan segmen judul sebagai transkripsi baru yang dihasilkan aplikasi Anda.

Judul otomatis dapat memuat kesalahan pengenalan. Jika Anda menggunakan teks untuk rangkuman atau kutipan, menyediakan cara untuk memeriksa segmen asli dan video. Ketersediaan dan akurasi adalah pertanyaan yang terpisah: berhasil mengambil trek tidak menjamin bahwa kata-katanya benar.

Bandingkan Transkrip API dan Captions API, atau menjelajahi YouTube Data APIs.