YouTube ٹرانسکرپٹ API
ایک درخواست، مکمل ٹرانسکرپٹ۔ صرف ان ویڈیوز کی ادائیگی کریں جو آپ حاصل کرتے ہیں۔
اپنی مفت API کلید حاصل کریںفوری آغاز
- سائن ان کریں اور API ڈیش بورڈ پر API کلید بنائیں۔ آپ کو 10 مفت کریڈٹ (5 ٹرانسکرپٹ) ملیں گے۔
- کلید کو YouTube URL یا ویڈیو ID کے ساتھ X-API-Key ہیڈر میں بھیجیں۔
- مزید ضرورت ہو تو کریڈٹ پیک خریدیں، یا خودکار ٹاپ اپ آن کریں۔
curl -X POST https://sum.video/api/v1/transcript \
-H "X-API-Key: sv_live_your_key" \
-H "Content-Type: application/json" \
-d '{"url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ", "lang": "en"}'درخواست
POST /api/v1/transcript
url: YouTube URL (watch، youtu.be، shorts، embed یا live لنک)۔ یہ یا video_id استعمال کریں۔video_id: 11 حروف پر مشتمل YouTube ویڈیو ID۔lang: پسندیدہ کیپشن زبان، مثلاً en، de یا pt-BR۔ ڈیفالٹ en ہے۔ اگر وہ زبان موجود نہ ہو تو اصل ٹریک واپس کیا جاتا ہے اور جواب اس کی اصل زبان بتاتا ہے۔format: json (ٹائم اسٹیمپ والے حصے، ڈیفالٹ)، text یا srt۔
import requests
response = requests.post(
"https://sum.video/api/v1/transcript",
headers={"X-API-Key": "sv_live_your_key"},
json={"video_id": "dQw4w9WgXcQ", "lang": "en", "format": "text"},
timeout=120,
)
print(response.json()["text"])const response = 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({ url: "https://youtu.be/dQw4w9WgXcQ" }),
});
const { segments, credits_remaining } = await response.json();جواب
{
"video_id": "dQw4w9WgXcQ",
"language": "en",
"is_generated": false,
"credits_used": 2,
"credits_remaining": 98,
"segments": [
{ "text": "We're no strangers to love", "offset": 18.64, "duration": 3.24 }
]
}خرابیاں
| 401 | invalid_key | API کلید موجود نہیں، غلط ہے یا منسوخ ہو چکی ہے۔ |
| 400 | invalid_input | URL یا ویڈیو ID پڑھی نہیں جا سکی۔ |
| 402 | insufficient_credits | آپ کا بیلنس 2 کریڈٹ سے کم ہے۔ |
| 402 | budget_exceeded | آپ اپنی مقرر کردہ ماہانہ کریڈٹ حد تک پہنچ گئے ہیں۔ |
| 404 | no_transcript | ویڈیو میں کیپشن نہیں، یا وہ نجی، لائیو یا حذف شدہ ہے۔ فیس نہیں لی جائے گی۔ |
| 429 | rate_limited | ایک کلید پر فی منٹ 60 سے زیادہ درخواستیں۔ Retry-After کے سیکنڈز تک انتظار کریں۔ |
| 502 | upstream_error | YouTube نے وقت پر جواب نہیں دیا۔ فیس نہیں لی جائے گی، بعد میں دوبارہ کوشش کریں۔ |
اپنا بیلنس دیکھیں
curl https://sum.video/api/v1/credits -H "X-API-Key: sv_live_your_key"قیمتیں
ہر ٹرانسکرپٹ 2 کریڈٹ کا ہے۔ کریڈٹ کبھی ختم نہیں ہوتے۔ Pro سبسکرائبرز کو ہر ماہ 100 بونس کریڈٹ ملتے ہیں۔
| پیک | کریڈٹ | ٹرانسکرپٹ | قیمت | فی ٹرانسکرپٹ |
|---|---|---|---|---|
| Starter | 100 | 50 | $4.49 | $0.090 |
| Pro | 500 | 250 | $13.99 | $0.056 |
| Scale | 2,000 | 1,000 | $37.99 | $0.038 |
| Business | 5,000 | 2,500 | $74.99 | $0.030 |
خودکار ٹاپ اپ، بجٹ اور الرٹ
- جب بیلنس آپ کی منتخب کردہ حد سے نیچے جاتا ہے تو خودکار ٹاپ اپ آپ کے محفوظ کارڈ سے ایک پیک خریدتا ہے۔
- ماہانہ ٹاپ اپ بجٹ طے کرتا ہے کہ خودکار ٹاپ اپ کتنا خرچ کر سکتا ہے، اور ماہانہ کریڈٹ حد پوری ہونے پر درخواستیں رک جاتی ہیں۔
- ای میل الرٹ بتاتے ہیں جب بیلنس کم ہو، جب آپ ماہانہ حد کے 80% تک پہنچیں، یا جب کوئی ٹاپ اپ ناکام ہو۔
حدود اور منصفانہ استعمال
فی کلید فی منٹ 60 درخواستیں، فی اکاؤنٹ زیادہ سے زیادہ 5 فعال کلیدیں۔ API وہی کیپشن واپس کرتا ہے جو YouTube پر پہلے سے موجود ہیں؛ یہ آڈیو کو ٹرانسکرائب نہیں کرتا۔ ٹرانسکرپٹ کو ویڈیو مالکان کے حقوق اور YouTube کی شرائط کے مطابق استعمال کرنا آپ کی ذمہ داری ہے۔
عمومی سوالات
- کیا مجھے اسی ویڈیو کے لیے دوبارہ ادائیگی کرنی ہوگی؟
- جی ہاں، ہر کامیاب درخواست 2 کریڈٹ کی ہے، لیکن دہرائی گئی ویڈیوز ہمارے کیش سے ملی سیکنڈز میں مل جاتی ہیں۔
- اگر ویڈیو میں کیپشن نہ ہوں تو کیا ہوگا؟
- آپ کو no_transcript خرابی ملے گی اور کوئی کریڈٹ نہیں کٹے گا۔
- کیا یہ دوسرے ٹرانسکرپٹ API کے ساتھ ہم آہنگ ہے؟
- درخواست اور جواب عام url، lang اور segments ڈھانچے پر چلتے ہیں، اس لیے تبدیلی میں عموماً صرف بیس URL اور کلید بدلنی ہوتی ہے۔