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