API ашиглан YouTube транскрипт хэрхэн авах вэ (curl, Python, JavaScript)

YouTube транскриптийг API-аар авахын тулд видеоны URL эсвэл ID болон API түлхүүртэй нэг HTTP хүсэлт илгээж, хариунаас транскриптийг уншаарай. Энэ гарын авлага sum.video Transcript API-г ашиглан хүсэлтийг curl, Python, JavaScript-ээр үзүүлж, дараа нь формат, алдаа, зардлыг тайлбарлана.

API юуг буцаадаг вэ

Төгсгөлийн цэг нь нийтэд нээлттэй YouTube видеоны байгаа хадмал-уудыг буцаадаг, тэр нь бүтээгчийн бичсэн ч, YouTube автоматаар үүсгэсэн ч байж болно. Энэ нь дууг бичвэр болгодоггүй. Видеонд хадмал байхгүй бол таамаглалын оронд алдаа авна (доор дэлгэрэнгүй).

Үндсэн зүйлс:

• Төгсгөлийн цэг: POST https://sum.video/api/v1/transcript (GET ч ажиллана)
• Нэвтрэлт: таны түлхүүр X-API-Key толгойд, эсвэл Authorization: Bearer <key>
• Оролт: url эсвэл video_id
• Заавал биш lang (өгөгдмөл en)
• Заавал биш format: json, text эсвэл srt

Хариу нь мөн хадмал трэкийн жинхэнэ хэл болон автоматаар үүссэн эсэхийг хэлдэг тул ямар чанар хүлээхийг мэдэж болно.

1-р алхам: API түлхүүр үүсгэх

Нэвтэрч API самбар (/dashboard/api, sum.video дээр) дээр түлхүүр үүсгээрэй. Та 5 хүртэл идэвхтэй түлхүүртэй байж болох бөгөөд энэ нь туршилтын болон бүтээгдэхүүний түлхүүрийг салгахад тустай. Таны эхний түлхүүр 10 үнэгүй кредиттэй ирдэг бөгөөд энэ нь 5 транскриптэд хүрнэ, тиймээс доорх бүхнийг үнэгүй туршиж болно.

2-р алхам: Эхний хүсэлтээ илгээх

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 ч ажилладаг тул зөвхөн URL бүтээдэг скриптээс ч турших боломжтой. Түлхүүрийг лог руу орохгүйн тулд толгойд дамжуулсан нь дээр.

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+ эсвэл хөтөч)

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());
}

Түлхүүрийг серверт хадгалаарай. Хөтчийн кодод байгаа түлхүүрийг хөгжүүлэгчийн хэрэгслийг нээсэн хэн ч хуулж авч чадна.

3-р алхам: Зөв форматыг сонгох

Видеоны тодорхой агшин руу холбоос өгөхөөр төлөвлөсөн бол json ашиглаж, холбоосыг сегментийн offset-оос үүсгээрэй. LLM-д өгөхөд text жижиг бөгөөд хялбар. Хожим транскрипт дотроос гараар хайхыг хүсвэл YouTube видеоны транскрипт дотроос хэрхэн хайх вэ-г үзээрэй.

4-р алхам: Хэл сонгох

lang өгөгдмөлөөр en байна. Хүссэн хэлээ, жишээлбэл de эсвэл es гэж тохируулаарай. Хариу нь үнэхээр буцаагдсан трэкийн хэлийг мэдээлдэг тул таамаглахын оронд шалгаарай. Видеонд ихэвчлэн нэг л хадмал трэк байдаг бөгөөд API жинхэнэ хадмалыг буцаадаг тул таны өмнөөс орчуулдаггүй.

5-р алхам: Алдааг зохицуулах

Эдгээр тохиолдлыг эхний өдрөөс төлөвлөөрэй:

• 404 no_transcript: видеонд хадмал байхгүй, эсвэл шууд дамжуулалт, хувийн видео, устгагдсан видео. Дахин оролдох зүйл алга. Алгасаарай, эсвэл хэрэглэгчээс өөр видео асууна уу.
• 402 budget_exceeded: та тогтоосон сарын кредитийн хязгаарт хүрлээ. Дараагийн хэсгийг үзнэ үү.
• Хурдны хязгаар: түлхүүр тус бүр минутад 60 хүсэлтийг зөвшөөрнө. Багц ажлуудыг тараан гүйцэтгэж, хязгаарлагдсан үедээ удаашруулаарай.
• Бидний талын доголдол: богино завсарласны дараа дахин оролдоорой. Эдгээр нь зардалгүй.

Серверийн алдаа гарвал дахин оролдож, 404 гарвал алгасдаг энгийн давталт ихэнх үйлдвэрлэлийн хэрэгцээг хангана.

Зардал хэд вэ

Транскрипт бүр 2 кредит болдог. Транскрипт буцаадаггүй эсвэл sum.video-ийн талд бүтэлгүйтсэн хүсэлтүүд зардалгүй тул 404 хэзээ ч таны үлдэгдлийг шавхдаггүй. Үлдэгдлээ GET /api/v1/credits-ээр харж болно.

Кредитүүд хэзээ ч дуусдаггүй нэг удаагийн багцаар зарагддаг:

Pro захиалагчид сар бүр 100 урамшууллын кредит ч авдаг. Бүхэл бүтэн суваг оруулах мэт хүнд ажилд автомат цэнэглэлт болон төсвийг хөндсөн том цар хүрээтэй RAG апп-д зориулсан YouTube транскриптүүд сценарийг уншаарай. Үнэ-ийг ч үзээрэй.

Барихаасаа өмнө мэдэх хязгаарлалтууд

• Зөвхөн хадмалтай видеонууд ажиллана. Энэ нь 404 no_transcript-ийн гол шалтгаан.
• Автоматаар үүссэн хадмалд алдаа байж болно, ялангуяа нэр, өнгө аяс, техникийн нэр томьёонд.
• API зөвхөн транскриптийг буцаадаг. Хураангуйлдаггүй. Транскриптийн дээр хураангуй, цагийн тэмдэг, чат хүсвэл YouTube хураангуйлагч үүнийг хийдэг бөгөөд транскриптийн хэрэгсэл нь нэг видеонд зориулсан кодгүй хувилбар юм.
• Албан ёсны YouTube Data API энд орлох зүйл биш. Хадмал татах арга нь видеог засах эрх шаарддаг тул таны өөрийн видеонуудад зориулагдсан (Google-ийн баримт бичиг).

Эх сурвалж

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