መመሪያዎችበ Péter Nagy29 ኦክቶበር 2026

የYouTube ትራንስክሪፕትን በኤፒአይ እንዴት ማግኘት ይቻላል (curl፣ Python፣ JavaScript)

የማንኛውንም ይፋዊ የYouTube ቪዲዮ ትራንስክሪፕት በአንድ የHTTP ጥያቄ ያግኙ። የሚሠሩ የcurl፣ Python እና JavaScript ምሳሌዎች፣ የውጤት ቅርጸቶች፣ የስህተት ኮዶች እና ወጪዎች።

የYouTube ትራንስክሪፕትን በኤፒአይ ለማግኘት፣ የቪዲዮውን URL ወይም መለያ እና የኤፒአይ ቁልፍ ያካተተ አንድ የHTTP ጥያቄ ይላኩ፣ ከዚያም ትራንስክሪፕቱን ከምላሹ ያንብቡ። ይህ መመሪያ የsum.video የትራንስክሪፕት ኤፒአይን በመጠቀም ጥያቄውን በcurl፣ Python እና JavaScript ያሳያል፣ ከዚያም ቅርጸቶችን፣ ስህተቶችን እና ወጪን ይዳስሳል።

ኤፒአይው የሚመልሰው

ይህ የመጨረሻ ነጥብ የአንድ ይፋዊ የ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፦ የኤፒአይ ቁልፍ ይፍጠሩ

ይግቡና በኤፒአይ ዳሽቦርድ (በ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ዎችን ብቻ ከሚገነባ ስክሪፕት መሞከር ይችላሉ። ቁልፉ በምዝግብ ማስታወሻ ውስጥ እንዳይገባ በራስጌ ቢሰጡት ይሻላል።

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` እና `duration` ያላቸው	የጊዜ ማህተሞች፣ ወደ አንድ ቅጽበት የሚወስዱ አገናኞች፣ በጊዜ መከፋፈል
`text`	ግልጽ ትራንስክሪፕት	ጥያቄዎች፣ የፍለጋ ማውጫዎች፣ ማጠቃለያዎች
`srt`	የንዑስ ርዕስ ፋይል ይዘት	የቪዲዮ አርታኢዎች፣ የንዑስ ርዕስ መሣሪያዎች

ወደ ቪዲዮው አንድ ቅጽበት ማገናኘት ከፈለጉ json ይጠቀሙና አገናኙን ከክፍሉ offset ይገንቡ። ለLLM ለመመገብ text ያነሰና ቀላል ነው። በኋላ በትራንስክሪፕት ውስጥ በእጅ መፈለግ ከፈለጉ በYouTube ቪዲዮ ትራንስክሪፕት ውስጥ እንዴት መፈለግ ይቻላል ይመልከቱ።

ደረጃ 4፦ ቋንቋ ይምረጡ

lang በነባሪ en ነው። የሚፈልጉትን ቋንቋ ያዘጋጁ፣ ለምሳሌ de ወይም es። ምላሹ በእርግጥ የተመለሰውን ትራክ ቋንቋ ይገልጻል፣ ስለዚህ ከመገመት ይልቅ ያረጋግጡት። ቪዲዮ ብዙ ጊዜ አንድ የንዑስ ርዕስ ትራክ ብቻ አለው፣ ኤፒአይውም እውነተኛ ንዑስ ርዕሶችን ይመልሳል፣ ስለዚህ አይተረጉምልዎትም።

ደረጃ 5፦ ስህተቶችን ይያዙ

ከመጀመሪያው ቀን ጀምሮ እነዚህን ሁኔታዎች ያቅዱ፦

404 no_transcript፦ ቪዲዮው ንዑስ ርዕስ የለውም፣ ወይም የቀጥታ ስርጭት፣ የግል ቪዲዮ ወይም የተሰረዘ ቪዲዮ ነው። እንደገና የሚሞከር ምንም ነገር የለም። ይዝለሉት፣ ወይም ተጠቃሚውን ሌላ ቪዲዮ ይጠይቁ።
402 budget_exceeded፦ ያዘጋጁትን ወርሃዊ የክሬዲት ገደብ ደርሰዋል። ቀጣዩን ክፍል ይመልከቱ።
የፍጥነት ገደብ፦ እያንዳንዱ ቁልፍ በደቂቃ 60 ጥያቄዎችን ይፈቅዳል። የቡድን ሥራዎችን ያራርቁ፣ ሲገደቡም ይቀንሱ።
በእኛ በኩል የሚደርሱ ውድቀቶች፦ ከአጭር መዘግየት በኋላ እንደገና ይሞክሩ። ምንም አያስከፍሉም።

በአገልጋይ ስህተቶች ላይ እንደገና የሚሞክርና በ404 ላይ የሚዘል ቀላል ዑደት አብዛኛውን የምርት ፍላጎት ይሸፍናል።

ምን ያህል ያስከፍላል

እያንዳንዱ ትራንስክሪፕት 2 ክሬዲት ያስከፍላል። ትራንስክሪፕት የማይመልሱ ወይም በsum.video በኩል የሚወድቁ ጥያቄዎች ምንም አያስከፍሉም፣ ስለዚህ 404 ቀሪ ሂሳብዎን በጭራሽ አያሟጥጥም። ቀሪ ሂሳብዎን በGET /api/v1/credits ማየት ይችላሉ።

ክሬዲቶች በአንድ ጊዜ ግዢ ጥቅሎች ይሸጣሉ፣ በጭራሽ አያልፉም፦

ጥቅል	ዋጋ	በትራንስክሪፕት
100 ክሬዲት	$4.49	$0.090
500 ክሬዲት	$13.99	$0.056
2,000 ክሬዲት	$37.99	$0.038
5,000 ክሬዲት	$74.99	$0.030

የPro ተመዝጋቢዎች በየወሩ 100 ተጨማሪ ክሬዲቶችም ያገኛሉ። ለከባድ ሥራ፣ ለምሳሌ ሙሉ ቻናል ማስገባት፣ ራስ-ሰር መሙላትንና በጀቶችን የሚሸፍነውን ሁኔታ ለRAG መተግበሪያ በትልቅ ደረጃ የYouTube ትራንስክሪፕቶች ያንብቡ። ዋጋዎችንም ይመልከቱ።

ከመገንባትዎ በፊት ሊያውቋቸው የሚገቡ ገደቦች

ንዑስ ርዕስ ያላቸው ቪዲዮዎች ብቻ ይሠራሉ። ለ404 no_transcript ዋናው ምክንያት ይህ ነው።
በራስ-ሰር የተፈጠሩ ንዑስ ርዕሶች ስህተት ሊኖራቸው ይችላል፣ በተለይ በስሞች፣ በአነጋገር እና በቴክኒካዊ ቃላት ላይ።
ኤፒአይው ትራንስክሪፕቱን ብቻ ይመልሳል። አያጠቃልልም። በትራንስክሪፕት ላይ ማጠቃለያ፣ የጊዜ ማህተሞች እና ውይይት ከፈለጉ የYouTube አጠቃላይ ያደርገዋል፣ የትራንስክሪፕት መሣሪያው ደግሞ ለአንድ ቪዲዮ ያለ ኮድ የሚሠራ ስሪት ነው።
ይፋዊው የYouTube Data API እዚህ ምትክ አይደለም። የንዑስ ርዕስ ማውረጃ ዘዴው ቪዲዮውን የማርትዕ ፈቃድ ይፈልጋል፣ ስለዚህ ለራስዎ ቪዲዮዎች የታሰበ ነው (የGoogle ሰነድ)።

ምንጮች

ተደጋግሞ የሚነሱ ጥያቄዎች

ያለ ይፋዊው YouTube Data API የYouTube ትራንስክሪፕት ማግኘት እችላለሁ?

አዎ። የsum.video የትራንስክሪፕት ኤፒአይ የቪዲዮ URL ወይም መለያ ወስዶ ነባር ንዑስ ርዕሶችን ይመልሳል፣ የGoogle Cloud ፕሮጀክት አያስፈልግም። የGoogle የራሱ የንዑስ ርዕስ ማውረጃ ዘዴ ቪዲዮውን የማርትዕ ፈቃድ ይፈልጋል፣ ስለዚህ ለራስዎ ቪዲዮዎች ብቻ ይሠራል።

ኤፒአይው ንዑስ ርዕስ የሌላቸውን ቪዲዮዎች ይተረጉማል?

አይ። ነባር የYouTube ንዑስ ርዕሶችን፣ በእጅ የተጻፉ ወይም በራስ-ሰር የተፈጠሩ፣ ይመልሳል። ንዑስ ርዕስ የሌላቸው ቪዲዮዎች፣ የቀጥታ ስርጭቶች፣ የግል እና የተሰረዙ ቪዲዮዎች 404 no_transcript ይመልሳሉ፣ ያ ጥያቄም ምንም አያስከፍልም።

አንድ ትራንስክሪፕት ስንት ያስከፍላል?

በትራንስክሪፕት 2 ክሬዲት። ጥቅሎች ከ100 ክሬዲት በ$4.49 ($0.090 በትራንስክሪፕት) እስከ 5,000 ክሬዲት በ$74.99 ($0.030 በትራንስክሪፕት) ይደርሳሉ፣ ክሬዲቶችም በጭራሽ አያልፉም።

ምን የውጤት ቅርጸቶች አሉ?

json (በሰከንድ offset እና duration ያላቸው ክፍሎች)፣ text እና srt። በጥያቄው ውስጥ format መስኩን ያዘጋጁ።

በነፃ እንዴት ልሞክረው?

የመጀመሪያው የኤፒአይ ቁልፍዎ ከ10 ነፃ ክሬዲቶች ጋር ይመጣል፣ ይህም 5 ትራንስክሪፕቶች ነው። የPro ተመዝጋቢዎች በየወሩ 100 ተጨማሪ ክሬዲቶችም ያገኛሉ።

የyoutube ትራንስክሪፕት ኤፒአይየኤፒአይ መማሪያpythonjavascriptcurl