የ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 እና ቁልፉን መቀየር ማለት ነው።