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 | 4,49 US$ | 0,090 US$ |
| Pro | 500 | 250 | 13,99 US$ | 0,056 US$ |
| Scale | 2000 | 1000 | 37,99 US$ | 0,038 US$ |
| Business | 5000 | 2500 | 74,99 US$ | 0,030 US$ |
ავტომატური შევსება, ბიუჯეტები და შეტყობინებები
- ავტომატური შევსება ყიდულობს პაკეტს შენახული ბარათით, როცა ბალანსი თქვენ მიერ არჩეულ ზღვარს ქვემოთ ჩამოდის.
- თვიური შევსების ბიუჯეტი ზღუდავს ავტომატური შევსების ხარჯს, ხოლო თვიური კრედიტის ლიმიტი აჩერებს მოთხოვნებს მისი მიღწევისას.
- ელფოსტის შეტყობინებები გაცნობებთ, როცა ბალანსი დაბალია, როცა თვიური ლიმიტის 80%-ს მიაღწევთ ან როცა შევსება ვერ მოხერხდა.
ლიმიტები და სამართლიანი გამოყენება
60 მოთხოვნა წუთში თითო გასაღებზე, ანგარიშზე მაქსიმუმ 5 აქტიური გასაღები. API აბრუნებს სუბტიტრებს, რომლებიც უკვე არსებობს YouTube-ზე; ის აუდიოს არ ატრანსკრიბირებს. თქვენ პასუხისმგებელი ხართ ტრანსკრიპტების გამოყენებაზე ვიდეოს მფლობელების უფლებებისა და YouTube-ის პირობების შესაბამისად.
ხშირად დასმული კითხვები
- ვიხდი ისევ იმავე ვიდეოსთვის?
- დიახ, თითოეული წარმატებული მოთხოვნა 2 კრედიტი ღირს, მაგრამ განმეორებითი ვიდეოები ჩვენი ქეშიდან მილიწამებში ბრუნდება.
- რა ხდება, როცა ვიდეოს სუბტიტრები არ აქვს?
- მიიღებთ no_transcript შეცდომას და კრედიტები არ ჩამოგეჭრებათ.
- თავსებადია სხვა ტრანსკრიპტის API-ებთან?
- მოთხოვნა და პასუხი მიჰყვება გავრცელებულ url, lang და segments ფორმას, ამიტომ გადასვლა ჩვეულებრივ ნიშნავს საბაზისო URL-ისა და გასაღების შეცვლას.