API తో YouTube ట్రాన్స్‌క్రిప్ట్ ఎలా పొందాలి (curl, Python, JavaScript)

API తో YouTube ట్రాన్స్‌క్రిప్ట్ పొందడానికి, వీడియో URL లేదా ID మరియు API కీతో HTTP అభ్యర్థనను పంపి, ప్రతిస్పందన నుంచి ట్రాన్స్‌క్రిప్ట్‌ను చదవండి. ఈ గైడ్ sum.video Transcript API తో curl, Python, JavaScript లో అభ్యర్థనను చూపించి, తర్వాత ఫార్మాట్లు, ఎర్రర్లు, ఖర్చును వివరిస్తుంది.

API ఏమి తిరిగి ఇస్తుంది

ఈ endpoint ఒక పబ్లిక్ YouTube వీడియోలో ఇప్పటికే ఉన్న క్యాప్షన్లను తిరిగి ఇస్తుంది, అవి సృష్టికర్త రాసినవైనా YouTube ఆటోమేటిక్‌గా సృష్టించినవైనా. ఇది ఆడియోను ట్రాన్స్‌క్రైబ్ చేయదు. వీడియోకు క్యాప్షన్లు లేకపోతే, అంచనా బదులు ఎర్రర్ వస్తుంది (కింద మరిన్ని వివరాలు).

ప్రాథమికాలు:

• Endpoint: 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 డాష్‌బోర్డ్‌లో (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 నుంచి కూడా పరీక్షించవచ్చు. కీ లాగ్‌లలోకి చేరకుండా ఉండటానికి దాన్ని హెడర్‌లో పంపడం మంచిది.

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 లో వదిలేసే సాధారణ loop చాలా ప్రొడక్షన్ అవసరాలను తీరుస్తుంది.

ఖర్చు ఎంత

ప్రతి ట్రాన్స్‌క్రిప్ట్‌కు 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