API එකකින් YouTube ට්‍රාන්ස්ක්‍රිප්ට් එකක් ලබාගන්නේ කොහොමද (curl, Python, JavaScript)

API එකකින් YouTube ට්‍රාන්ස්ක්‍රිප්ට් එකක් ලබාගන්න, වීඩියෝවේ URL එක හෝ ID එක සහ API යතුරක් සමඟ HTTP ඉල්ලීමක් යවන්න, පසුව ප්‍රතිචාරයෙන් ට්‍රාන්ස්ක්‍රිප්ට් එක කියවන්න. මෙම මඟපෙන්වීම sum.video Transcript API භාවිතයෙන් curl, Python සහ JavaScript වල ඉල්ලීම පෙන්වා, පසුව ආකෘති, දෝෂ සහ පිරිවැය පැහැදිලි කරයි.

API එක ආපසු දෙන්නේ මොනවාද

මෙම endpoint එක පොදු YouTube වීඩියෝවක පවතින සිරස්තල (captions) ආපසු දෙයි, ඒවා නිර්මාණකරුවා ලියූ ඒවා හෝ YouTube විසින් ස්වයංක්‍රීයව සාදන ලද ඒවා විය හැක. එය ශබ්දය ට්‍රාන්ස්ක්‍රයිබ් කරන්නේ නැහැ. වීඩියෝවේ captions නැත්නම්, අනුමානයක් වෙනුවට ඔබට දෝෂයක් ලැබේ (පහත බලන්න).

මූලික කරුණු:

• Endpoint: POST https://sum.video/api/v1/transcript (GET ද වැඩ කරයි)
• සත්‍යාපනය: ඔබේ යතුර X-API-Key header එකේ, හෝ Authorization: Bearer <key>
• ආදානය: url හෝ video_id
• විකල්ප lang (පෙරනිමිය en)
• විකල්ප format: json, text හෝ srt

ප්‍රතිචාරය caption track එකේ සැබෑ භාෂාවත්, එය ස්වයංක්‍රීයව සාදන ලද්දක්ද යන්නත් කියයි, එවිට ඔබට බලාපොරොත්තු විය යුතු ගුණාත්මකභාවය දැනගත හැක.

පියවර 1: API යතුරක් සාදන්න

පිවිසී API dashboard එකේ (sum.video හි /dashboard/api) යතුරක් සාදන්න. ඔබට සක්‍රීය යතුරු 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 එක පමණක් සාදන script එකකින්ද පරීක්ෂා කළ හැක. යතුර logs වලට නොවැටීමට header එකේ යැවීම හොඳයි.

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

යතුර සර්වරයේ තබාගන්න. බ්‍රවුසර කේතයේ ඇති යතුර developer tools විවෘත කරන ඕනෑම කෙනෙකුට පිටපත් කළ හැක.

පියවර 3: නිවැරදි ආකෘතිය තෝරන්න

වීඩියෝවේ මොහොතකට සබැඳියක් දීමට සැලසුම් කරන්නේ නම් json භාවිතා කර කොටසේ offset එකෙන් සබැඳිය සාදන්න. LLM එකකට දීමට text කෙටි සහ සරලයි. පසුව ට්‍රාන්ස්ක්‍රිප්ට් එක තුළ අතින් සෙවීමට අවශ්‍ය නම්, YouTube වීඩියෝවක ට්‍රාන්ස්ක්‍රිප්ට් එකේ සොයන්නේ කොහොමද බලන්න.

පියවර 4: භාෂාව තෝරන්න

lang පෙරනිමිය en වේ. ඔබට අවශ්‍ය භාෂාව, උදාහරණයක් ලෙස de හෝ es, සකසන්න. ප්‍රතිචාරය සැබෑවටම ආපසු දුන් track එකේ භාෂාව කියයි, එබැවින් අනුමාන නොකර එය පරීක්ෂා කරන්න. වීඩියෝවක බොහෝවිට ඇත්තේ caption track එකක් පමණයි, සහ API එක සැබෑ captions ආපසු දෙන නිසා ඔබ වෙනුවෙන් පරිවර්තනය නොකරයි.

පියවර 5: දෝෂ හසුරුවන්න

පළමු දවසේ සිටම මේවාට සැලසුම් කරන්න:

• 404 no_transcript: වීඩියෝවේ captions නැත, නැතහොත් එය සජීවී විකාශනයක්, පෞද්ගලික හෝ ඉවත් කළ වීඩියෝවකි. නැවත උත්සාහ කිරීමට කිසිවක් නැහැ. එය මඟ හරින්න, නැතහොත් පරිශීලකයාගෙන් වෙනත් වීඩියෝවක් ඉල්ලන්න.
• 402 budget_exceeded: ඔබ සකසන ලද මාසික ක්‍රෙඩිට් සීමාවට ළඟා වී ඇත. ඊළඟ කොටස බලන්න.
• අනුපාත සීමාව: සෑම යතුරක්ම විනාඩියකට ඉල්ලීම් 60ක් ඉඩ දෙයි. කණ්ඩායම් වැඩ ඒවා අතර පැතිරවන්න, සීමා කළ විට මන්දගාමී වන්න.
• අපේ පැත්තේ අසාර්ථකතා: ටික වේලාවකට පසු නැවත උත්සාහ කරන්න. මේවාට ගාස්තුවක් නැහැ.

සර්වර් දෝෂවලදී නැවත උත්සාහ කර 404 දී මඟ හරින සරල loop එකක් නිෂ්පාදන අවශ්‍යතා බොහොමයක් ආවරණය කරයි.

පිරිවැය කොපමණද

සෑම ට්‍රාන්ස්ක්‍රිප්ට් එකකටම වැය වන්නේ ක්‍රෙඩිට් 2ක්. ට්‍රාන්ස්ක්‍රිප්ට් ආපසු නොදෙන හෝ sum.video පැත්තෙන් අසාර්ථක වන ඉල්ලීම්වලට ගාස්තුවක් නැහැ, එබැවින් 404 ඔබේ ශේෂය කිසිදා හිස් නොකරයි. ශේෂය GET /api/v1/credits මගින් බලන්න.

ක්‍රෙඩිට් විකිණෙන්නේ කිසිදා කල් ඉකුත් නොවන එක්-වරක් පැකේජ ලෙසයි:

Pro ග්‍රාහකයන්ට මසකට බෝනස් ක්‍රෙඩිට් 100ක් ද ලැබේ. සම්පූර්ණ චැනලයක් ගෙන ඒම වැනි බර වැඩ සඳහා, ස්වයංක්‍රීය ටොප්-අප් සහ අයවැය ආවරණය කරන විශාල පරිමාණයේ RAG යෙදුමක් සඳහා YouTube ට්‍රාන්ස්ක්‍රිප්ට් අවස්ථාව කියවන්න. මිල ගණන් ද බලන්න.

ගොඩනැගීමට පෙර දැනගත යුතු සීමා

• captions ඇති වීඩියෝ පමණක් වැඩ කරයි. 404 no_transcript සඳහා ප්‍රධාන හේතුව එයයි.
• ස්වයංක්‍රීය captions වල වැරදි තිබිය හැක, විශේෂයෙන් නම්, උච්චාරණ සහ තාක්ෂණික වචනවල.
• API එක ආපසු දෙන්නේ ට්‍රාන්ස්ක්‍රිප්ට් එක පමණයි. එය සාරාංශ සාදන්නේ නැහැ. ට්‍රාන්ස්ක්‍රිප්ට් එක ගැන සාරාංශ, කාල මුද්‍රා සහ චැට් අවශ්‍ය නම් YouTube සාරාංශකරු එය කරයි, සහ ට්‍රාන්ස්ක්‍රිප්ට් මෙවලම එක් වීඩියෝවකට කේත රහිත අනුවාදයයි.
• නිල YouTube Data API මෙහි ආදේශකයක් නොවේ. එහි captions බාගැනීමේ ක්‍රමයට වීඩියෝව සංස්කරණය කිරීමේ අවසරය අවශ්‍ය නිසා එය ඔබේම වීඩියෝ සඳහායි (Google ලේඛන).

මූලාශ්‍ර

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