İçeriğe geç
TR
API anahtarı al

YouTube Data / JavaScript

YouTube altyazıları: Bir dili seçin ve eksik parçaları idare edin

Otomatik veya yükleyici-provided YouTube komutlarını dil tarafından seçin, zamanları korur ve JavaScript ile açıkça eksik parçaları idare edin.

FlashData · Yayınlanmış Yayınlanmış Yayınlandı

Video çerçevenin altında seçilen bir video çerçevesi ile iki satır

Bir video İngilizce otomatik altyazıları, bir yükleyici-provided İspanyol pisti, ikisi de veya ikisi olabilir. Bir dil için sormak, videonun sahip olmadığı bir yol yaratmaz. Bu kılavuz, seçilen pisti sessiz bir şekilde başka bir dil veya komut kaynağı olmadan nasıl kurtaracağını gösterir.

Otomatik komutlar ve yükleyici-provided captions

FlashData iki uygun kaynağı ortaya çıkarır: youtube_transcript Otomatik satırlara varsayılan varsayılanlar, oysa youtube_captions Yüklemek için varsayılan komutlar. Her ikisi de açık bir şekilde destekler params.auto değer: true Otomatik satırları seçin ve false Yükleyici-provided captions seçin. Her ikisi de mevcut YouTube sıralarını alır ve zamansız segmentleri döndürür.

Set Set Set params.language İhtiyacınız olan yolda, örneğin en, es veya veya veya en-US. Bölgesel bir kod ve bir dil-sadece kod, değiştirilemez vaatler değildir. İstenen dil ve komut kaynağı mevcut değilse, istek başarısız olabilir veya kullanılabilir bir metine sahip olamaz. API otomatik olarak tercüme etmez, konuşma-yap üretir veya takip kaynakları arasında geri düşer.

İstek göndermeden önce bir iz seçin

Node.js 22 veya daha sonra ve bir an API anahtarı Mevcut Kredilerle. Bir video ID'yu ayarlamanız için izin verilir. Temel metin ihracat akışı için, bakınız Get Get GetGet Get Get YouTube alt başlıklarla JavaScript.

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

Use Use Use CAPTION_AUTO=false Bir yüklemeleyici-provided pisti isteyin. Senaryo tam olarak bir istek gönderir. Her dili denemez veya ilk başarısız olduğunda ikinci ücretli bir istek otomatik olarak sorun.

Seçilmiş pisti Fetch ve Zamanları Devam Ediyor

Aşağıdaki kodu kurtarmak gibi caption-track.mjs. Giriş seçimini doğrular, araç seviyesindeki hataların yanı sıra HTTP başarısızlıkları için kontrol eder ve yanıtda bildirilen dil ve kaynak bilgilerini korur.

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

Talep edilen pist eksik olduğunda ne yapmalı

  • Adım ayarları değiştirmeden önce hatayı kontrol edin. Başarısız bir anahtar, yetersiz krediler veya bir süre boyunca videonun altyazısız olduğuna dair kanıt değildir.

  • Video metadata'yı zaten getiriyorsanız, denetim hasTranscripts Ve ve transcriptLanguages Yararlı işaretler olarak. Raporlanmış bir dil, bu dilde hem otomatik hem de yükleyici parçalarının var olduğunu garanti etmez.

  • Alternatif bir iz kullanımınız için kabul edilebilirse, kasıtlı olarak seçin ve ayrı bir istek yapın. Talep edilen ve geri dönen dili ve isAutoGenerated metin ile değer.

  • Eğer iş akışınız tam pisti gerektiriyorsa, öğeyi mevcut değildir ve diğer videolarla devam edin. Tekrar tekrarlanan aynı istek eksik komutlar yaratmayacaktır.

Dilinizi ve zamanlarını metininizle kanıtlayın

Segmentler içerir start, end Ve ve text; saniyeler içinde zaman ölçülmektedir. Video ID ve dili arama chunks içine bir transkript ayırdığınızda tut. Bir zamanlar silinmiş bir video bağlantısı, bir okuyucunun orijinal bağlamı doğrulamasına yardımcı olabilir. Uygulamanızın üretildiği yeni bir transkript segmentini tedavi etmekten kaçının.

Otomatik satırlar tanıma hataları içerebilir. Summaries veya alıntılar için metni kullanıyorsanız, orijinal segmenti ve videoyu incelemenin bir yolunu sağlayın. Erişilebilirlik ve doğruluk ayrı sorulardır: başarıyla bir takip etmek onun kelimelendirilmesinin doğru olduğunu garanti etmez.

Karşılaştırmayı karşılaştırın Transcript API Ve ve Captions API, ya da keşfedin YouTube Data APIs.