Langkau ke kandungan
MS
Dapatkan kunci API

YouTube Data / JavaScript

Taksi YouTube: pilih bahasa dan kendalikan trek yang hilang

Oacher Pilih aplikasi otomatis atau uploader-disediakan YouTube oleh bahasa, menjaga timestamp, dan menangani trek yang hilang secara eksplisit dengan JavaScript.

FlashData · Diterbitkan

Dua jalur kapsi dengan satu dipilih di bawah bingkai video

Sebuah video dapat memiliki kapsi otomatis bahasa Inggris, sebuah uploader-disediakan trek Spanyol, baik, maupun keduanya. Kata-kata yang digunakan untuk bahasa tidak menciptakan trek yang tidak dimiliki video. Panduan ini membuat pilihan kapsi secara eksplisit dan menunjukkan cara menyimpan trek yang dipilih tanpa secara diam-diam menggantikan bahasa lain atau sumber kapsi.

Aplikasi aplikasi otomatis dan aplikasi yang disediakan oleh uploader

FlashData mengekspos dua sumber mudah: youtube_transcript default swalayan ke kapsi otomatis, sementara youtube_captions default untuk uploader-disediakan kapsi. Keduanya mendukung sebuah eksplisit params.auto Nilai: true Orang-orang yang memilih gambar otomatis dan false \"Officida pilih aplikasi uploader-provided\". Kedua-duanya mengambil kembali kapsi YouTube yang sudah ada dan kembali segmen yang telah distempel.

**Ditetapkan* params.language Misalnya, ke trek yang Anda butuhkan en, es OR atau ORANG en-US. Kode regional dan kode bahasa-saja tidak saling berubah janji. Jika bahasa dan sumber kapsi yang diminta tidak tersedia, permintaan dapat gagal atau tidak memiliki teks yang dapat digunakan. API tidak diterjemahkan secara otomatis, menghasilkan pidato-ke-teks, atau jatuh kembali di antara sumber trek.

AKAN Pilih satu trek sebelum mengirim permintaan

Gunakan Node.js 22 atau nanti dan Kunci API Ketersediaan kredit. Tetapkan ID video Anda diperbolehkan untuk memproses. Untuk ekspor teks dasar aliran kerja, lihat Dapatkan YouTube Subtitles with JavaScript.

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

Guna CAPTION_AUTO=false Untuk meminta uploader-provided track. Skrip mengirimkan tepat satu permintaan. Ia tidak mencoba setiap bahasa atau mengeluarkan permintaan dibayar kedua secara otomatis ketika yang pertama gagal.

Ambil trek yang dipilih dan simpan timestamps

Simpan kode berikut sebagai caption-track.mjs. Ia mengesahkan pilihan input, memeriksa kesalahan tingkat alat serta kegagalan HTTP, dan melestarikan 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

  • Cek kesalahan sebelum mengubah pengaturan kapsi. Kunci yang tidak sah, kredit yang tidak mencukupi atau waktu habis bukanlah bukti bahwa video itu kurang kapsi.

  • Jika Anda sudah mengambil data meta video, periksalah hasTranscripts Dan transcriptLanguages Zaflin sebagai sinyal yang berguna. Bahasa yang dilaporkan tidak menjamin bahwa baik jejak otomatis maupun uploader-provided ada dalam bahasa tersebut.

  • Jika sebuah jalur alternatif dapat diterima untuk kasus penggunaan Anda, pilihlah dengan sengaja dan buatlah permintaan terpisah. Catatan yang diminta dan dikembalikan bahasa dan isAutoGenerated Nilai dari teks.

  • Jika alur kerja Anda membutuhkan trek yang tepat, tandai item tidak tersedia dan lanjutkan dengan video lain. Secara berulang-ulang mengirimkan permintaan yang sama tidak akan membuat kapsi yang hilang.

Jaga bahasa dan waktu membuktikan dengan teks Anda

Segmen mengandung start, end Dan text; Waktu diukur dalam hitungan detik. Pastikan video ID dan bahasa ketika membelah transkrip ke dalam potongan pencarian. Sebuah link video yang distempel waktu dapat membantu pembaca memverifikasi konteks aslinya. Jangan menganggap segmen kapsi sebagai transkripsi baru yang dihasilkan aplikasi Anda.

Kapsi otomatis yang dimiliki oleh foto-foto itu dapat mengandung kesalahan pengenalan. Jika Anda menggunakan teks untuk jumlah atau kutipan, memberikan cara untuk memeriksa segmen asli dan video. Ketersediaan dan keakuratan adalah pertanyaan terpisah: berhasil mendapatkan trek tidak menjamin bahwa pengkataannya benar.

Bandingkan dengan API Dan Kapsi kapsi API, atau menjelajahi API YouTube Data.