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