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 | ১০০ | ৫০ | ৪.৪৯ US$ | ০.০৯০ US$ |
| Pro | ৫০০ | ২৫০ | ১৩.৯৯ US$ | ০.০৫৬ US$ |
| Scale | ২,০০০ | ১,০০০ | ৩৭.৯৯ US$ | ০.০৩৮ US$ |
| Business | ৫,০০০ | ২,৫০০ | ৭৪.৯৯ US$ | ০.০৩০ US$ |
অটো টপ-আপ, বাজেট ও সতর্কতা
- আপনার বেছে নেওয়া সীমার নিচে ব্যালান্স নামলে অটো টপ-আপ সংরক্ষিত কার্ড দিয়ে একটি প্যাক কিনে নেয়।
- মাসিক টপ-আপ বাজেট ঠিক করে অটো টপ-আপ কত খরচ করতে পারবে, আর মাসিক ক্রেডিট সীমা পূর্ণ হলে অনুরোধ বন্ধ হয়ে যায়।
- ব্যালান্স কমে গেলে, মাসিক সীমার 80%-এ পৌঁছালে বা টপ-আপ ব্যর্থ হলে ইমেইলে জানানো হয়।
সীমা ও ন্যায্য ব্যবহার
প্রতি কী-তে প্রতি মিনিটে 60টি অনুরোধ, প্রতি অ্যাকাউন্টে সর্বোচ্চ 5টি সক্রিয় কী। API শুধু YouTube-এ আগে থেকে থাকা ক্যাপশন ফেরত দেয়; এটি অডিও ট্রান্সক্রাইব করে না। ভিডিও মালিকদের অধিকার ও YouTube-এর শর্ত মেনে ট্রান্সক্রিপ্ট ব্যবহার করা আপনার দায়িত্ব।
প্রায়শই জিজ্ঞাসিত প্রশ্ন
- একই ভিডিওর জন্য কি আবার টাকা দিতে হবে?
- হ্যাঁ, প্রতিটি সফল অনুরোধ 2 ক্রেডিট, তবে বারবার চাওয়া ভিডিও আমাদের ক্যাশ থেকে মিলিসেকেন্ডে দেওয়া হয়।
- ভিডিওতে ক্যাপশন না থাকলে কী হয়?
- আপনি no_transcript ত্রুটি পাবেন এবং কোনো ক্রেডিট কাটা হবে না।
- এটি কি অন্যান্য ট্রান্সক্রিপ্ট API-এর সাথে সামঞ্জস্যপূর্ণ?
- অনুরোধ ও উত্তর প্রচলিত url, lang ও segments কাঠামো মেনে চলে, তাই বদলাতে সাধারণত শুধু বেস URL আর কী পরিবর্তন করলেই হয়।