API ilə YouTube transkriptini necə əldə etmək olar (curl, Python, JavaScript)

API ilə YouTube transkriptini əldə etmək üçün videonun URL-i və ya ID-si ilə API açarını göndərən bir HTTP sorğusu göndər və transkripti cavabdan oxu. Bu bələdçi sorğunu sum.video Transcript API ilə curl, Python və JavaScript-də göstərir, sonra formatlara, xətalara və xərclərə keçir.

API nə qaytarır

Son nöqtə açıq YouTube videosunun mövcud subtitrlərini qaytarır: istər müəllifin yazdığı, istərsə YouTube-un avtomatik yaratdığı. O, səsi mətnə çevirmir. Videonun subtitri yoxdursa, təxmin əvəzinə xəta alırsan (aşağıda daha ətraflı).

Əsaslar:

• Son nöqtə: POST https://sum.video/api/v1/transcript (GET də işləyir)
• Autentifikasiya: açarın X-API-Key başlığında, yaxud Authorization: Bearer <key>
• Giriş: url və ya video_id
• İstəyə bağlı lang (susmaya görə en)
• İstəyə bağlı format: json, text və ya srt

Cavab həm də subtitr trekinin real dilini və onun avtomatik yaradılıb-yaradılmadığını bildirir, beləliklə hansı keyfiyyətə gözləmək lazım olduğunu bilirsən.

1-ci addım: API açarı yarat

Daxil ol və API panelində (sum.video-da /dashboard/api) açar yarat. Aktiv açarların sayı 5-ə qədər ola bilər, bu da test açarını istehsal açarından ayırmaq üçün əlverişlidir. İlk açarınla 10 pulsuz kredit gəlir, bu 5 transkript üçün kifayətdir, beləliklə aşağıdakıların hamısını xərcsiz sınaya bilərsən.

2-ci addım: İlk sorğunu göndər

curl

curl -X POST https://sum.video/api/v1/transcript \
  -H "X-API-Key: $SUMVIDEO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ", "lang": "en", "format": "text"}'

GET də işlədiyindən, yalnız URL qurur skriptdən də sınaya bilərsən. Açarın loqlara düşməməsi üçün onu başlıqda ötürmək daha yaxşıdır.

Python

import os
import requests

resp = requests.post(
    "https://sum.video/api/v1/transcript",
    headers={"X-API-Key": os.environ["SUMVIDEO_API_KEY"]},
    json={"video_id": "dQw4w9WgXcQ", "lang": "en", "format": "text"},
    timeout=30,
)

if resp.status_code == 404:
    print("No captions for this video")
else:
    resp.raise_for_status()
    print(resp.text)

JavaScript (Node 18+ və ya brauzer)

const resp = await fetch("https://sum.video/api/v1/transcript", {
  method: "POST",
  headers: {
    "X-API-Key": process.env.SUMVIDEO_API_KEY,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    video_id: "dQw4w9WgXcQ",
    lang: "en",
    format: "text",
  }),
});

if (resp.status === 404) {
  console.log("No captions for this video");
} else if (!resp.ok) {
  throw new Error(`Request failed: ${resp.status}`);
} else {
  console.log(await resp.text());
}

Açarı serverdə saxla. Brauzer koduna qoyulmuş açarı tərtibatçı alətlərini açan hər kəs kopyalaya bilər.

3-cü addım: Düzgün formatı seç

Videonun müəyyən anına keçid vermək istəyirsənsə, json istifadə et və keçidi seqmentin offset dəyərindən qur. LLM-ə vermək üçün text daha kiçik və sadədir. Sonra transkript daxilində əl ilə axtarmaq istəsən, YouTube videosunun transkripti daxilində necə axtarmaq olar yazısına bax.

4-cü addım: Dil seç

lang susmaya görə en-dir. Onu istədiyin dilə təyin et, məsələn de və ya es. Cavab əslində qaytarılan trekin dilini bildirir, ona görə fərz etmək əvəzinə yoxla. Videonun çox vaxt yalnız bir subtitr treki olur, API isə real subtitrləri qaytarır, yəni onları sənin üçün tərcümə etmir.

5-ci addım: Xətaları idarə et

Bu halları ilk gündən nəzərə al:

• 404 no_transcript: videonun subtitri yoxdur, ya da canlı yayım, gizli video və ya silinmiş videodur. Təkrar cəhd etməyə dəyməz. Onu keç, ya da istifadəçidən başqa video istə.
• 402 budget_exceeded: təyin etdiyin aylıq kredit limitinə çatdın. Növbəti bölməyə bax.
• Sürət limiti: hər açar dəqiqədə 60 sorğuya icazə verir. Toplu işləri aralıqla işlət və məhdudlaşdırılanda yavaşla.
• Bizim tərəfdəki nasazlıqlar: qısa gecikmədən sonra yenidən cəhd et. Onlar heç nəyə başa gəlmir.

Server xətalarında yenidən cəhd edən və 404-də keçən sadə dövr istehsalın əksər ehtiyaclarını ödəyir.

Nəyə başa gəlir

Hər transkript 2 kredit tutur. Transkript qaytarmayan və ya sum.video tərəfində uğursuz olan sorğular heç nəyə başa gəlmir, belə ki 404 balansını heç vaxt azaltmır. Balansı GET /api/v1/credits ilə görə bilərsən.

Kreditlər heç vaxt başa çatmayan birdəfəlik paketlərlə satılır:

Pro abunəçiləri hər ay 100 bonus kredit də alır. Daha ağır iş yükü üçün, məsələn bütöv kanalı yükləmək üçün, avtomatik doldurma və büdcələri əhatə edən ssenarini, böyük miqyasda RAG tətbiqi üçün YouTube transkriptləri oxu. Qiymətlərə də bax.

Qurmazdan əvvəl bilməli olduğun məhdudiyyətlər

• Yalnız subtitri olan videolar işləyir. 404 no_transcript-in əsas səbəbi budur.
• Avtomatik yaradılmış subtitrlərdə, xüsusən adlarda, vurğularda və texniki terminlərdə səhvlər ola bilər.
• API yalnız transkripti qaytarır. Xülasə etmir. Transkriptin üstündə xülasə, zaman damğaları və çat istəyirsənsə, bunu YouTube xülasəçisi edir, transkript aləti isə bir video üçün kodsuz versiyadır.
• Rəsmi YouTube Data API burada əvəz deyil. Onun subtitr yükləmə metodu videonu redaktə etmək icazəsi tələb edir, ona görə sənin öz videoların üçündür (Google sənədi).

Mənbələr

• YouTube Data API: Captions.download
• sum.video Transcript API