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 بناتا ہو۔ کی کو ہیڈر میں بھیجنا بہتر ہے تاکہ وہ لاگ میں نہ جائے۔

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