Siapkan lingkungan Anda
Use Node.js 22 atau nanti. Naskah menggunakan built-in fetch API dan berkas, jadi tidak ada paket yang diperlukan. Anda perlu kunci API, kredit yang tersedia dan ID dari sebuah video dengan trek kapsi yang sudah ada.
# Replace YOUR_API_KEY near the top of the code below.
export YOUTUBE_VIDEO_ID='dQw4w9WgXcQ'Video ID adalah v Nilai di YouTube watch URL. Untuk titik akhir ini, melewati ID melalui video_id.
Kutip dan simpan gambarnya
Simpan kode sebagai transcript.mjs. Ia meminta trek otomatis Inggris, menulis teks biasa ke satu berkas dan menyimpan objek transkrip lengkap di yang lain.
import { writeFile } from "node:fs/promises";
const apiKey = "YOUR_API_KEY";
const videoId = process.env.YOUTUBE_VIDEO_ID;
if (!videoId) {
throw new Error("Set YOUTUBE_VIDEO_ID first.");
}
const baseUrl = "https://data.flashdata.dev";
const response = await fetch(baseUrl + "/v1/queries/realtime", {
method: "POST",
headers: {
"Content-Type": "application/json",
"X-API-Key": apiKey,
},
body: JSON.stringify({
source: "youtube_transcript",
video_id: videoId,
params: { language: "en", auto: true },
}),
signal: AbortSignal.timeout(60000),
});
const payload = await response.json();
if (!response.ok || payload.error) {
throw new Error(payload.message ?? payload.detail ?? "Transcript request failed");
}
const transcript = payload.results?.[0];
if (!Array.isArray(transcript?.segments) || transcript.segments.length === 0) {
throw new Error("No caption segments were returned for this video and language.");
}
const text = transcript.segments.map(segment => segment.text).join("\n");
await writeFile("transcript.txt", text, "utf8");
await writeFile("transcript.json", JSON.stringify(transcript, null, 2), "utf8");
console.log("Saved transcript.txt and transcript.json (with segment timestamps).");
node transcript.mjstranscript.txt WOVE adalah mudah untuk membaca atau memproses teks lebih lanjut. transcript.json Bahasa dan segmen timestamp.
Jagalah timestamps
Segmen Kapsi siar telah start, end Dan text Medan. Saat membangun indeks pencarian, simpan video ID, bahasa dan timestamp dengan setiap potongan sehingga sebuah kecocokan dapat menunjuk kembali ke video.
{
"source": "youtube_transcript",
"status": "done",
"results": [
{
"videoId": "dQw4w9WgXcQ",
"languageCode": "en",
"languageName": null,
"isAutoGenerated": true,
"segments": [
{
"start": 0.32,
"end": 14.58,
"text": "[Music]"
},
{
"start": 18.8,
"end": 25.96,
"text": "We're no strangers to"
},
{
"start": 21.8,
"end": 29.119,
"text": "love. You know the rules and so do"
},
{
"start": 25.96,
"end": 30.279,
"text": "I. I feel commitments from what I'm"
},
{
"start": 29.119,
"end": 34.36,
"text": "thinking"
},
{
"start": 30.279,
"end": 39.559,
"text": "of. You wouldn't get this from any other"
},
{
"start": 34.36,
"end": 43.12,
"text": "guy. I just want to tell you how I'm"
},
{
"start": 39.559,
"end": 45.84,
"text": "feeling. Got to make you understand."
},
{
"start": 43.12,
"end": 49.2,
"text": "Never going to give you up. I'm going to"
},
{
"start": 45.84,
"end": 53.32000000000001,
"text": "let you down. I'm going to run around"
},
{
"start": 49.2,
"end": 56.399,
"text": "and desert you. I'm going to make"
},
{
"start": 53.32,
"end": 59.879,
"text": "you say goodbye."
},
{
"start": 56.399,
"end": 64.04,
"text": "Tell a lie and hurt"
},
{
"start": 59.879,
"end": 67.2,
"text": "you. We've known each other for so"
},
{
"start": 64.04,
"end": 70.56,
"text": "long. Your heart's been aching, but"
},
{
"start": 67.2,
"end": 72.60000000000001,
"text": "you're too shy to say we don't know"
},
{
"start": 70.56,
"end": 77.799,
"text": "what's been going"
},
{
"start": 72.6,
"end": 81.479,
"text": "on. We know the game and we're going to"
},
{
"start": 77.799,
"end": 84.56,
"text": "play. If you ask me how I'm"
},
{
"start": 81.479,
"end": 88.32,
"text": "feeling, don't tell me your truth. to"
},
{
"start": 84.56,
"end": 88.32000000000001,
"text": "see. I will give"
},
{
"start": 89.88,
"end": 94.72,
"text": "you"
},
{
"start": 91.72,
"end": 94.72,
"text": "around"
},
{
"start": 95,
"end": 99.04,
"text": "you. I will say"
},
{
"start": 99.56,
"end": 106.759,
"text": "goodbye and hurt you. I will give"
},
{
"start": 103.99,
"end": 108.6,
"text": "[Music]"
},
{
"start": 106.759,
"end": 115.92,
"text": "you"
},
{
"start": 108.6,
"end": 115.92,
"text": "around you. I will leave you. I will say"
},
{
"start": 116.439,
"end": 121.079,
"text": "goodbye and hurt you."
},
{
"start": 128.319,
"end": 132.56,
"text": "Never going to give. Never going to"
},
{
"start": 129.759,
"end": 134,
"text": "give."
},
{
"start": 132.56,
"end": 136.8,
"text": "Never going to give. Never going to"
},
{
"start": 134,
"end": 141.04,
"text": "give."
},
{
"start": 136.8,
"end": 143.68,
"text": "We've known each other for so long."
},
{
"start": 141.04,
"end": 147.51999999999998,
"text": "Your heart's been aching, but you're too"
},
{
"start": 143.68,
"end": 148.52,
"text": "shy to say it. We both know what's been"
},
{
"start": 147.52,
"end": 152.239,
"text": "going"
},
{
"start": 148.52,
"end": 157.8,
"text": "on. We know the game and we're going to"
},
{
"start": 152.239,
"end": 161.36,
"text": "play it. I just want to tell you how I'm"
},
{
"start": 157.8,
"end": 163.92000000000002,
"text": "feeling. Got to make you understand."
},
{
"start": 161.36,
"end": 166.8,
"text": "Never going to give you up. Never going"
},
{
"start": 163.92,
"end": 171.28,
"text": "to let you down. Never going to run"
},
{
"start": 166.8,
"end": 171.28,
"text": "around and desert you. Heat."
},
{
"start": 172.33,
"end": 182.76,
"text": "[Music]"
},
{
"start": 178.76,
"end": 182.76,
"text": "Heat. Heat. Heat."
},
{
"start": 183.39,
"end": 195.2,
"text": "[Music]"
},
{
"start": 191.04,
"end": 197.76,
"text": "Never going to tell a lie and hurt you."
},
{
"start": 195.2,
"end": 200.64,
"text": "Never going to give you up. Never going"
},
{
"start": 197.76,
"end": 204.239,
"text": "to let you down. Never going to run"
},
{
"start": 200.64,
"end": 206.83999999999995,
"text": "around and desert you. Never going to"
},
{
"start": 204.239,
"end": 211.879,
"text": "make you cry. Never going to say"
},
{
"start": 206.84,
"end": 211.879,
"text": "goodbye. Never going to say goodbye."
}
],
"fullText": "[Music] We're no strangers to love. You know the rules and so do I. I feel commitments from what I'm thinking of. You wouldn't get this from any other guy. I just want to tell you how I'm feeling. Got to make you understand. Never going to give you up. I'm going to let you down. I'm going to run around and desert you. I'm going to make you say goodbye. Tell a lie and hurt you. We've known each other for so long. Your heart's been aching, but you're too shy to say we don't know what's been going on. We know the game and we're going to play. If you ask me how I'm feeling, don't tell me your truth. to see. I will give you around you. I will say goodbye and hurt you. I will give [Music] you around you. I will leave you. I will say goodbye and hurt you. Never going to give. Never going to give. Never going to give. Never going to give. We've known each other for so long. Your heart's been aching, but you're too shy to say it. We both know what's been going on. We know the game and we're going to play it. I just want to tell you how I'm feeling. Got to make you understand. Never going to give you up. Never going to let you down. Never going to run around and desert you. Heat. [Music] Heat. Heat. Heat. [Music] Never going to tell a lie and hurt you. Never going to give you up. Never going to let you down. Never going to run around and desert you. Never going to make you cry. Never going to say goodbye. Never going to say goodbye."
}
],
"usage": {
"credits": 0.01
},
"created_at": "2026-09-16T07:45:44.040Z"
}Sebuah link video dapat mencakup &t=SECONDSs Untuk membuka diri di dekat awal segmen. Setem waktu (timetamps) adalah berguna untuk kutipan dan navigasi bahkan jika Anda menggabungkan beberapa segmen ke dalam satu dokumen.
Handle hilang kapsi
Ketersediaan kapsi tergantung pada jenis video, bahasa dan trek. Trek yang tidak tersedia COMVE dapat menghasilkan kesalahan atau tidak ada segmen yang dapat digunakan; skrip memeriksa kedua kasus dan berhenti dengan pesan.
Titik akhir ini mengambil kembali gambar yang ada. Mereka tidak menghasilkan keluaran baru dari pidato-ke-teks. Untuk trek yang disediakan pencipta, periksa Kapsi kapsi API Dan pilihannya. Hindari berulang kali mengajukan permintaan yang sama ketika trek yang diminta tidak ada.