YouTube පිටපත් API
එක් ඉල්ලීමක්, සම්පූර්ණ පිටපත. ඔබ ලබා ගන්නා වීඩියෝ සඳහා පමණක් ගෙවන්න.
ඔබේ නොමිලේ API යතුර ගන්නඉක්මන් ආරම්භය
- පුරනය වී API පුවරුවේ API යතුරක් සාදන්න. ඔබට නොමිලේ ණය 10ක් ලැබේ (පිටපත් 5ක්).
- යතුර X-API-Key ශීර්ෂයේ YouTube URL හෝ වීඩියෝ ID සමඟ යවන්න.
- වැඩිපුර අවශ්ය වූ විට ණය පැකේජයක් මිලදී ගන්න, නැතහොත් ස්වයංක්රීය පිරවීම සක්රිය කරන්න.
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 | US$4.49 | US$0.090 |
| Pro | 500 | 250 | US$13.99 | US$0.056 |
| Scale | 2,000 | 1,000 | US$37.99 | US$0.038 |
| Business | 5,000 | 2,500 | US$74.99 | US$0.030 |
ස්වයංක්රීය පිරවීම, අයවැය සහ ඇඟවීම්
- ඔබ තෝරන සීමාවට වඩා ශේෂය අඩු වූ විට ස්වයංක්රීය පිරවීම ඔබේ සුරැකි කාඩ්පතෙන් පැකේජයක් මිලදී ගනී.
- මාසික පිරවීමේ අයවැය ස්වයංක්රීය පිරවීමට වියදම් කළ හැකි මුදල සීමා කරයි, මාසික ණය සීමාවට ළඟා වූ විට ඉල්ලීම් නවත්වයි.
- ශේෂය අඩු වූ විට, මාසික සීමාවෙන් 80%කට ළඟා වූ විට, හෝ පිරවීම අසාර්ථක වූ විට ඊමේල් ඇඟවීම් ඔබට දන්වයි.
සීමා සහ සාධාරණ භාවිතය
යතුරකට විනාඩියකට ඉල්ලීම් 60ක්, ගිණුමකට සක්රිය යතුරු 5ක් දක්වා. API YouTube හි දැනටමත් ඇති උපසිරැසි ආපසු දෙයි; එය ශ්රව්ය පිටපත් නොකරයි. වීඩියෝ හිමිකරුවන්ගේ අයිතිවාසිකම් සහ YouTube නියමයන්ට අනුව පිටපත් භාවිත කිරීම ඔබේ වගකීමයි.
නිතර අසන ප්රශ්න
- එකම වීඩියෝවට නැවත ගෙවිය යුතුද?
- ඔව්, සෑම සාර්ථක ඉල්ලීමකටම ණය 2ක්, නමුත් පුනරාවර්තන වීඩියෝ අපගේ හැඹිලියෙන් මිලිතත්පර වලින් ලැබේ.
- වීඩියෝවට උපසිරැසි නැති විට කුමක් සිදුවේද?
- ඔබට no_transcript දෝෂයක් ලැබෙන අතර ණය කිසිවක් අඩු නොකෙරේ.
- එය වෙනත් පිටපත් API සමඟ ගැළපේද?
- ඉල්ලීම සහ ප්රතිචාරය පොදු url, lang සහ segments ආකෘතිය අනුගමනය කරයි, එබැවින් මාරු වීම සාමාන්යයෙන් මූලික URL සහ යතුර වෙනස් කිරීමයි.