API વડે YouTube ટ્રાન્સક્રિપ્ટ કેવી રીતે મેળવવી (curl, Python, JavaScript)

API વડે YouTube ટ્રાન્સક્રિપ્ટ મેળવવા માટે વીડિયોના 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 ડેશબોર્ડમાં (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 પરથી લિંક બનાવો. 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