Przejdź do treści
PL
Uzyskaj klucz API

YouTube Data / JavaScript

Podpisy YouTube: wybierz język i uchwyć brakujące utwory

Wybierz automatyczne lub uploader- pod warunkiem, że YouTube podpisy według języka, zachować znaczniki czasu i uchwycić brakujące utwory wyraźnie z JavaScript.

FlashData · Opublikowane

Dwa utwory z napisem wybranym poniżej ramki wideo

Film może mieć angielskie automatyczne podpisy, uploader- pod warunkiem hiszpańskiego toru, zarówno, lub żaden. Proszenie o język nie tworzy ścieżki, której wideo nie ma. Ten przewodnik sprawia, że wybór podpisków jest wyraźny i pokazuje, jak zapisać wybrany utwór bez cichego zastępowania innego języka lub źródła podpisków.

Automatyczne podpisy i podpisy dostarczane przez nadawcę

FlashData ujawnia dwa wygodne źródła: youtube_transcript Domyślnie automatyczne podpisy, podczas gdy youtube_captions Domyślny do podanego zapisu w systemie uploader- suppined. Oba popierają jednoznaczne params.auto wartość: true wybiera automatyczne podpisy oraz false wybiera podpisy z podpisami dostarczonymi przez operatora. Obie pobierają istniejące podpisy YouTube i powracają z oznaczonymi terminami.

Ustaw params.language do utworu, którego potrzebujesz, na przykład en, es lub en-US. Kod regionalny i tylko język - kod nie są wymienne obietnice. Jeżeli żądany język i źródło zapisu są niedostępne, żądanie może nie być możliwe lub nie ma użytecznego tekstu. API nie przekłada się automatycznie, nie generuje przemówień do tekstu ani nie wraca pomiędzy źródłami torów.

Wybierz jedną ścieżkę przed wysłaniem wniosku

Należy stosować Node.js 22 lub później oraz Klawisz API z dostępnymi kredytami. Ustaw wideo ID, które możesz przetwarzać. Podstawowy strumień eksportu tekstu, patrz Pobierz napisy YouTube za pomocą JavaScript.

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

Stosowanie CAPTION_AUTO=false do wniosku o uploadera dostarczonego toru. Scenariusz wysyła dokładnie jedną prośbę. Nie wypróbowuje każdego języka lub nie wydaje drugiego płatnego wniosku automatycznie, gdy pierwszy nie udaje.

Pobierz wybrany utwór i zachować znaczniki czasu

Zapisz następujący kod jako caption-track.mjs. Potwierdza wybór wejścia, sprawdza błędy poziomu narzędzi oraz błędy HTTP oraz zachowuje informacje językowe i źródłowe podane w odpowiedzi.

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

Co robić, gdy brakuje żądanego toru

  • Zaznacz błąd przed zmianą ustawień zapisu. Nieprawidłowy klucz, niewystarczające zasługi lub timeout nie jest dowodem, że wideo brakuje podpisy.

  • Jeśli już pobrać metadane wideo, sprawdź hasTranscripts oraz transcriptLanguages jako użyteczne sygnały. Zgłoszony język nie gwarantuje, że zarówno automatyczne jak i uploader- dostarczone utwory istnieją w tym języku.

  • Jeśli alternatywny utwór jest do przyjęcia w przypadku użycia, wybrać go celowo i złożyć osobny wniosek. Zapis żądanego i zwróconego języka oraz isAutoGenerated wartość z tekstem.

  • Jeśli Twój przepływ pracy wymaga dokładnego utworu, zaznacz element niedostępny i kontynuuj z innymi filmami. Wielokrotne wysyłanie tego samego wniosku nie spowoduje powstania brakujących napisów.

Zachowaj język i znacznik czasu z tekstem

Segmenty zawierają start, end oraz text; czasy mierzone są w sekundach. Przechowuj wideo ID i język przy dzieleniu transkrypcji na kawałki wyszukiwania. Oznaczony czasem link wideo może pomóc czytelnikowi zweryfikować oryginalny kontekst. Unikaj traktowania segmentu napisy jako nowej transkrypcji, że aplikacja produkowane.

Automatyczne podpisy mogą zawierać błędy rozpoznawania. Jeśli używasz tekstu do podsumowania lub notowań, należy zapewnić sposób, aby sprawdzić oryginalny segment i wideo. Dostępność i dokładność są osobnymi pytaniami: pomyślnie odzyskuje utwór nie gwarantuje poprawności jego brzmienia.

Porównaj Transcript API oraz Podpisy API, lub zbadać YouTube Data API.