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.
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.
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
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
hasTranscriptsdantranscriptLanguagessebagai 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
isAutoGeneratednilai 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.