본문으로 건너뛰기
KO
API 키 받기

YouTube Data / JavaScript

YouTube 캡션: 언어를 선택하고 누락된 트랙을 처리

자동 또는 로더 제공 YouTube 캡션을 언어로 선택하여 타임스탬프를 보존하고 JavaScript로 명시된 누락 된 트랙을 처리하십시오.

FlashData · 게시됨

두 개의 캡션 트랙과 하나 선택된 아래의 비디오 프레임

비디오는 영어 자동 캡션, 로스터 제공 스페인어 트랙, 둘 다, 또는 할 수 있습니다. 언어에 대한 질문은 비디오가 존재하지 않는 트랙을 만들지 않습니다. 이 가이드는 명시된 캡션 선택을 만들고 다른 언어 또는 캡션 소스를 유혹하지 않고 선택한 트랙을 저장하는 방법을 보여줍니다.

자동 캡션 및 로더 제공 캡션

FlashData는 2개의 편리한 근원을 드러냅니다: youtube_transcript 자동 캡션에 기본적으로, while youtube_captions 로더 프로비드 캡션에 기본값. 둘 다 명시된 지원 params.auto 가치: true 자동 캡션을 선택하고 false 업로드자 제공된 캡션을 선택합니다. 기존의 YouTube 캡션과 반환 타임스탬프 세그먼트를 검색합니다.

설치하기 params.language 필요한 트랙에, 예를 들어 en, es 또는 en-US. 지역 코드 및 언어 전용 코드는 교환할 수 없는 약속입니다. 요청된 언어 및 캡션 소스가 사용할 수 없는 경우, 요청은 실패하거나 사용 가능한 텍스트가 없습니다. API는 자동으로 번역되지 않으며, 음성을 텍스트로 생성하거나, 트랙 소스 사이에 돌아갑니다.

요청을 보내기 전에 하나의 트랙을 선택하십시오

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 Uploader-provided 트랙을 요청합니다. 스크립트는 정확히 하나의 요청을 보냅니다. 그것은 모든 언어를 시도하지 않거나 두 번째 유료 요청을 자동으로 첫 번째 실패.

선택된 트랙을 묶고 타임스탬프를 유지

다음 코드를 저장 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

요청된 트랙이 누락 될 때해야 할 일

  • caption 설정을 변경하기 전에 오류를 확인합니다. 잘못된 키, 충분한 크레딧 또는 타임 아웃은 비디오가 캡션이 부족한 증거가 아닙니다.

  • 이미 비디오 메타데이터를 읽으면 검사 hasTranscripts 으로 transcriptLanguages 유용한 신호로. 이 언어는 자동 및 업로드자가 제공 한 트랙이 해당 언어에 존재하지 않는 것을 보장하지 않습니다.

  • 대안 트랙이 사용 사례에 허용되면, deliberately를 선택하고 별도의 요청을 만듭니다. 요청 및 반환된 언어 및 기록 isAutoGenerated 본문에 값.

  • 작업 흐름이 정확한 트랙을 필요로한다면, 아이템을 사용할 수 없게 표시하고 다른 동영상으로 계속할 수 있습니다. 반복적으로 동일한 요청을 보내면 누락된 캡션을 만들 수 없습니다.

당신의 텍스트로 언어 및 타임스탬프 검증 유지

Segments는 포함합니다 start, end 으로 text; 시간은 초에서 측정됩니다. 비디오 ID 및 언어 검색 펑크로 변환 할 때. Timetamped video link는 독자가 원래의 컨텍스트를 확인하는 데 도움이 될 수 있습니다. 당신의 응용 프로그램이 생성 된 새로운 transcription으로 caption 세그먼트를 치료하지 마십시오.

자동 캡션은 인식 오류를 포함 할 수 있습니다. 당신은 summaries 또는 인용에 대한 텍스트를 사용하는 경우, 원래 세그먼트 및 비디오를 검사하는 방법을 제공합니다. availability 및 정확도는 별도의 질문입니다: 성공적으로 트랙을 검색하는 것은 그것의 낱말이 정확하다는 것을 보증하지 않습니다.

더 보기 Transcript의 API 으로 캡션 API, 또는 탐구 YouTube Data APIs에 대 한.